直接改 composer.json 的 "name" 字段无效，因不自动更新目录、命名空间或 autoload 映射；需同步修改 psr-4 命名空间、abandon 并重新提交 packagist、手动同步 git 仓库名等。
composer.json 里的 name 字段改了没用？先确认是否已发布到 Packagist
直接改 composer.json 中的 "name" 字段，只影响本地元数据和 packagist.org 上的包名（如果后续提交），不会自动重命名项目目录、命名空间或已有类文件。很多开发者以为改完就“项目名变了”，结果 autoload 失败、vendor/autoload.php 找不到类——因为 PSR-4 映射还指向旧命名空间。
- 修改前先检查
"autoload"和"autoload-dev"中的"psr-4"映射，比如"App\": "app/"—— 如果你把name从myorg/myoldapp改成myorg/mynewapp，但没同步改命名空间，自动加载器照旧按App\去找，和新名字毫无关系 - 若项目尚未发布，
name字段可随意改；若已在 Packagist 注册，改名后需手动在 packagist.org 上 abandon 旧包，并用新name重新提交（Packagist 不支持重命名） - Git 仓库名、本地文件夹名、Docker 镜像 tag、CI 脚本中硬编码的路径等，全得手动同步更新，Composer 不管这些
编辑 composer.json 配置文件的正确姿势
别用记事本双击打开改完就保存。Composer 对 JSON 格式敏感，缩进错误、末尾逗号、中文引号都会导致 composer install 报 JSON decode error。
- 优先用命令行工具修改：比如改 PHP 版本要求，运行
composer config platform.php "8.2.10"；加一个开发依赖：composer require --dev phpunit/phpunit—— 这些操作会自动校验并格式化写入 - 手动编辑时，用 VS Code 或 PHPStorm 等支持 JSON Schema 的编辑器，开启
json.schemas关联官方 schema（https://www.php.cn/link/5f783681c04fe0eca6ff5bb7838f1107），能实时提示字段合法性 -
repositories字段容易配错：自定义 VCS 仓库必须带"type": "vcs"，私有 Packagist 需用"type": "composer"，且 URL 必须可公开访问或已配置认证（auth.json）
composer.lock 文件能不能手改？
不能。它不是配置文件，而是精确依赖快照，由 composer install 或 composer update 自动生成。手动修改后，下次运行命令会被覆盖，且可能引发哈希校验失败、安装不一致等问题。
- 想锁定某个包版本？改
composer.json中的约束（如"monolog/monolog": "^3.0"→"^3.4.0"），再跑composer update monolog/monolog - 发现
composer.lock里有不该出现的包？说明之前执行过composer require或update时未加--no-dev，清理方式是删掉对应条目后运行composer install --no-dev（但更稳妥的是回退composer.json并重装） - 团队协作中，
composer.lock必须提交 Git —— 它保证所有人装的是一模一样的依赖树
改完配置后，为什么 composer install 没反应或报错？
常见原因是缓存和本地状态不一致。Composer 会缓存包信息、zip 包甚至整个 vendor 目录（启用 cache-dir 时），尤其在切换分支、改了 repositories 或换了 PHP 版本后，旧缓存很可能干扰解析。
- 先清缓存：
composer clear-cache（注意：这会清空所有包缓存，首次重装略慢） - 删掉
vendor/和composer.lock，再执行composer install—— 这是最干净的重装方式，适合调试环境 - 检查当前 PHP 版本是否满足
config.platform.php或require.php要求，错误信息通常是Your requirements could not be resolved，但根本原因可能是 PHP 版本不匹配 - Windows 用户注意路径权限：若
vendor/在 OneDrive 或 WSL 挂载点下，可能出现文件锁或 symlink 失败，建议移到纯 NTFS 路径
name 和调配置看着简单，真正卡住人的往往是 autoload 映射没跟上、lock 文件残留旧状态、或者跨环境缓存没清干净——这些地方不报大错，但会让类找不到、测试跑不通、CI 构建飘忽，得一个个对着 vendor/autoload.php 生成逻辑和 composer show 输出去核对。 
