Composer link包重命名后vendor仍为旧路径，因link仅建符号链接且不感知源目录变更；需先composer unlink，再确保本地包name字段更新并用新路径重新link，最后dump-autoload重建映射。

composer link 的包重命名后 vendor 目录里还是旧路径

这是因为 composer link 只在 vendor/ 下创建符号链接，不修改其目标路径或自动感知源目录的重命名。一旦你把本地包目录从 ../my-package 改成 ../my-new-package，vendor/vendor/name 仍指向原路径，而该路径已不存在，导致 autoload 失败或 Class not found。

修复必须分两步：先解除旧链接，再用新路径重建。不能跳过 unlink 直接 link，否则会报 Cannot create symbolic link: File exists。

• 进主项目根目录，执行 composer unlink vendor/name（注意不是 composer link --unlink）
• 确认本地包目录已重命名且含合法 composer.json
• 进新本地包目录，运行 composer link（需 Composer 2.4+ 或已装 composer-plugin-link）
• 回到主项目，运行 composer link vendor/name，此时链接将指向新路径

重命名后 composer dump-autoload 无效？

是的，composer dump-autoload 只刷新类映射，不修复符号链接本身。如果 vendor/vendor/name 是个断链（dangling symlink），PHP 自动加载器根本不会走到扫描那一步——它连目录都打不开，直接抛 Warning: require(): failed to open stream。

验证是否为断链：运行 ls -la vendor/vendor/name，若显示 broken 或路径红字，说明链接目标不存在。

• 别在断链状态下跑 dump-autoload，徒劳无功
• 先用 rm vendor/vendor/name 手动删掉断链（composer unlink 有时不彻底）
• 确保新本地包的 composer.json 中 "name" 字段已同步更新，否则 composer link vendor/name 会找不到匹配项
• 重链后立即跑 composer dump-autoload，确保新路径下的类被纳入 PSR-4 映射

为什么改了本地包名，composer update 反而把软链接干掉了

因为 composer update 默认按 composer.lock 还原，而 lock 文件里记录的是原始包名和版本（如 "dev-main"），它并不知道你手动建了软链接。一旦执行 update，Composer 发现 lock 里要求的是一个“远程可安装包”，就会把 vendor/ 下的符号链接替换成真实 zip 解压目录。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 永远不要对已 link 的包执行 composer update vendor/name，这是最常见误操作
• 如果已经发生，别急着重链，先检查 composer.lock 里该包的 source 类型是否还是 "type": "path" —— 若已变成 "type": "zip"，说明 path 仓库配置可能被覆盖或失效
• 恢复方式：删掉 vendor/vendor/name，重新加回 repositories 块并确保 require 写的是 "dev-main"，再跑 composer update vendor/name --with-dependencies

重命名后 autoload.php 里还留着旧路径怎么办

这是缓存残留。Composer 生成的 vendor/autoload.php 会把所有 PSR-4 映射硬编码进 autoload_psr4.php，如果旧包路径曾被扫描过，映射可能还在，导致 PHP 加载错误文件。

最稳妥的清理方式不是只跑 dump-autoload，而是强制重建整个 autoload 体系：

• 删掉 vendor/composer/autoload_*.php 全部文件（autoload_static.php、autoload_classmap.php 等）
• 删掉 vendor/composer/installed.php 和 installed.json（它们记录的是已安装包元数据，含旧路径）
• 再执行 composer dump-autoload --optimize，让 Composer 重新扫描当前 vendor/ 和所有 path 仓库下的有效包
• 若用 Laravel，顺手跑 php artisan config:clear 避免框架缓存 autoload 路径

重命名本地包不是改个文件夹名就完事，关键在三处同步：目录名、composer.json 里的 name、以及 composer link 的目标路径。漏掉任意一环，都会让 autoload 在某个环节静默失败，而不是报明确错误。