Composer path仓库修改后代码不生效，根本原因是symlink仅在首次install或update时创建，后续改源码不会自动刷新链接；需删vendor重装、强制update或关闭symlink验证。

Composer path 仓库修改后代码不生效的典型表现 改了 path 类型仓库本地源码，运行 composer install 或 composer update 后，应用里还是旧逻辑——不是缓存没清，也不是 autoload 没更新，而是 Composer 根本没把你的修改“同步”进去。 根本原因在于：Composer 的 path 仓库默认启用 symlink（符号链接），但只在首次安装或 composer update 时创建；后续你改源码，只要没触发重链接，它就一直用原来的链接指向（而链接本身不会自动刷新内容）。

确认是否真用了 symlink 而非 copy Composer 对 path 仓库的行为取决于 options.symlink 配置，默认为 true。你可以通过以下方式验证当前行为：

• 检查 vendor 下对应包目录：如果是个快捷方式（macOS/Linux 下 ls -la 显示 ->，Windows 下是“快捷方式”图标），说明是 symlink
• 查看项目根目录的 composer.json 中该仓库定义，是否有显式设置 "options": {"symlink": false}
• 运行 composer show vendor/package-name，输出中若含 source type : path 且 source url 是本地路径，基本可确定走的是 path 仓库

让修改立即生效的三种可靠做法

别等 Composer 自己发现你改了——主动干预才是关键：

Academic Composer Upload

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

下载

• 删掉 vendor 包再重装：执行 rm -rf vendor/vendor-name/package-name（Linux/macOS）或手动删除对应文件夹（Windows），再跑 composer install。这是最彻底、最不容易出错的方式
• 强制重链接（仅限 symlink 模式）：运行 composer update vendor-name/package-name --no-install 先更新锁文件，再加 --force-install 强制重建链接：composer install --force-install
• 临时关闭 symlink（适合调试）：在 composer.json 中为该 repo 显式设 "options": {"symlink": false}，然后 composer update。此时 Composer 会 copy 整个目录，之后你改源码就无效了——但反过来，你想测 copy 行为时就得这么干

容易被忽略的坑和副作用

几个看似无关、实则常导致“改了也不生效”的细节：

• vendor/autoload.php 缓存了类路径映射，改完代码后如果用了 APCu / OPCache，得重启 PHP 进程或清 opcache（opcache_reset()），否则即使文件变了，加载的还是旧字节码
• 某些 IDE（如 PHPStorm）会基于 vendor 目录做静态分析缓存，改了源码但没刷新索引，提示可能仍来自旧版本
• 如果你在 path 仓库里改了 composer.json（比如加了新 autoload 规则），必须回到主项目再跑一次 composer dump-autoload，否则新规则不进主项目的 autoloader
• CI/CD 环境通常禁用 symlink（COMPOSER_HOME/config.json 设了 "use-symlinks": false），本地有效的方法在线上可能直接失效

改 path 仓库代码不生效，从来不是“Composer 坏了”，而是 symlink 机制 + 缓存层 + autoload 生命周期叠加的结果。盯住 vendor 目录的真实状态，比反复 dump-autoload 有用得多。