Composer无rename命令，因项目名仅影响Packagist发布、依赖声明和autoload映射，不涉及运行时逻辑；重命名须手动同步修改composer.json的name字段、psr-4命名空间、PHP文件namespace声明及Git远程地址。
Composer 本身不提供重命名项目功能，它只管理依赖和自动加载配置；项目重命名必须手动修改多处文件，并同步更新 Composer 相关配置。
为什么 composer rename 不存在
Composer 没有内置重命名命令——这不是遗漏，而是设计使然。项目名称（如 "name" 字段）仅用于 Packagist 发布、依赖声明和 autoload 命名空间映射，不影响本地执行，因此官方不提供自动化重命名工具。
强行用脚本批量替换可能破坏命名空间逻辑或 autoload 映射，尤其当旧名出现在类名、路径、测试用例或文档中时。
必须手动修改的 4 个关键位置
重命名后若 Composer 自动加载失效、composer dump-autoload 报错或类找不到，大概率是以下某处漏改：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json中的"name"字段（格式为"vendor/project-name"），影响 Packagist 推送和 require 引用 -
composer.json中的"autoload"/"autoload-dev"下的"psr-4"映射，例如"App\": "src/"→ 若原命名空间含旧项目名（如"MyOldProject\": "src/"），必须同步更新 - 所有 PHP 文件顶部的
namespace声明（尤其是src/和tests/下），例如namespace MyOldProject;→namespace MyNewProject; - Git 仓库远程地址（可选但推荐）：
git remote set-url origin https://github.com/vendor/my-new-project.git
composer dump-autoload 失败的常见原因
重命名后运行 composer dump-autoload 报 Class not found 或警告“no namespace found”，通常是因为：
-
composer.json的 autoload 映射路径写错，比如把"MyNewProject\": "src/"写成"MyNewProject\": "src/App/"，而实际类文件在src/下 - PHP 文件里
namespace和 autoload 映射不一致，例如映射是"App\"，但文件里写的是namespace MyNewProjectCommands; - 缓存未清：执行
composer clear-cache后再dump-autoload - 用了
classmap而非psr-4，需手动运行composer dump-autoload -o重新扫描
建议的最小安全操作顺序
避免边改边测导致状态混乱，按此顺序操作最稳妥：
- 先备份整个项目目录（或确保 Git 已 commit 当前状态）
- 用 IDE 全局替换
MyOldProject→MyNewProject，但**跳过vendor/、composer.lock和node_modules/** - 手动检查并修正
composer.json的"name"和"autoload"部分 - 删掉
vendor/和composer.lock，再运行composer install（强制重建 autoload） - 运行
php -d display_errors=1 -f src/YourMainClass.php或简单脚本验证基础类加载
真正麻烦的不是改名本身，而是命名空间与文件路径、autoload 配置、代码内引用这三者的严格一致性——少一处，composer dump-autoload 就会静默失败，而错误提示往往不直接指向根源。
