composer唯一认的项目名称是composer.json中name字段的vendor/name格式值，改名需同步更新psr-4自动加载映射及代码中命名空间引用，重命名composer.json文件会导致命令报错且破坏工具链兼容性。
项目名称和 composer.json 文件名是两回事：改项目名不等于重命名文件，而且 Composer 本身根本不读取文件名。
项目名称存在 name 字段里，不是文件名
Composer 唯一认的“项目名称”是 composer.json 里的 name 字段值，格式为 vendor/name（比如 myorg/myapp）。这个字段影响 Packagist 发布、依赖解析、自动加载命名空间推导等。
- 修改它只需编辑
composer.json中的"name": "oldvendor/oldname"→ 改成新值 - 改完后建议运行
composer dump-autoload，尤其当用了 PSR-4 自动加载且命名空间跟旧name绑定时 - 如果项目已发布到 Packagist，改
name相当于换了个新包，旧包不会自动重定向
别重命名 composer.json 文件
Composer 默认只识别 composer.json（以及可选的 composer.lock）。你把它改成 myapp.json 或 composer-dev.json，composer install 就会直接报错：Could not find a composer.json file in /path/to/project。
- 真要多配置？用
--file参数指定，比如composer install --file=composer-dev.json - 但注意：
autoload、scripts、require等所有逻辑仍按该文件内容执行，和原composer.json无关 - CI/CD、docker、ide 等工具也默认找
composer.json，改名等于主动制造兼容问题
什么时候会误以为要“重命名文件”？
常见于想区分开发/生产配置，或迁移旧项目。其实根本不需要动文件名：
- 环境差异用
COMPOSER环境变量切换配置文件：COMPOSER=composer-dev.json composer install - 私有包或临时调试可用
repositories字段内联定义，不用另起文件 - 想保留历史记录？直接在 git 提交信息里写清楚变更意图，比改文件名靠谱得多
最常被忽略的一点：很多人改了 name 却没同步更新 autoload 的 psr-4 映射或 vendor 目录下的实际命名空间，结果类找不到——名字改了，代码里 use 的还是旧路径，这比文件名问题更致命。