直接修改 repositories 配置可切换 path 依赖，但须同步清理 vendor 和 lock 文件，否则 Composer 缓存旧解析结果导致本地依赖不生效或远程包被跳过。
直接改 repositories 配置就能切换，但必须同步清理 vendor 和 lock 文件，否则 Composer 会缓存旧解析结果，导致本地 path 依赖不生效或远程包被意外跳过。
path 仓库配置写法和生效前提
在项目 composer.json 的 repositories 数组里加一条 type: "path" 条目，url 必须是相对于项目根目录的绝对路径（支持 ../）或完整路径：
{
"repositories": [
{
"type": "path",
"url": "../my-shared-package"
}
],
"require": {
"acme/utils": "@dev"
}
}
注意点：
-
acme/utils的name字段必须和本地包composer.json中声明的一致，大小写敏感 -
@dev是关键——Composer 只有在版本约束为@dev、dev-main、dev-develop等开发分支别名时，才会启用 path 仓库；如果写"^1.0"，它仍会走 Packagist - 本地包目录下必须存在有效的
composer.json，且不能有语法错误，否则composer install会报Could not load package acme/utils
从本地 path 切回远程依赖的三步操作
很多人以为删掉 repositories 就完事了，结果 vendor 里还是 symlink，类照常加载——这是因为 Composer 缓存了包来源信息，且 composer.lock 里仍记录着本地路径的 dist 类型。
必须做这三件事：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 从
composer.json中移除或注释掉对应path仓库条目 - 删除
vendor/acme/utils目录（仅删这个包，不要全删 vendor） - 运行
composer update acme/utils --with-dependencies，强制重新解析该包来源并更新 lock
验证是否切回成功：
- 检查
composer.lock中acme/utils的dist字段是否变成"type": "zip"或"type": "tar"，而不是"type": "path" - 看
vendor/acme/utils是否变成普通文件夹（非 symlink） - 执行
composer show acme/utils，输出中的source行应显示 Git URL 或 Packagist 地址
多环境自动切换：用脚本钩子 + 环境变量兜底
你没法让 Composer 原生识别 APP_ENV=prod，但可以用 scripts 钩子在 install/update 前动态改 composer.json。适合 CI/CD 流水线中“开发环境用本地 path，其他环境强制远程”这种场景。
示例（在项目 composer.json 中）：
{
"scripts": {
"pre-install-cmd": [
"if [ \"$APP_ENV\" = \"local\" ]; then sed -i '' 's|\"type\": \"packagist\"|\"type\": \"packagist\", {\"type\":\"path\",\"url\":\"../my-shared-package\"}|' composer.json; fi"
],
"post-install-cmd": [
"if [ \"$APP_ENV\" != \"local\" ]; then composer remove acme/utils --no-interaction && composer require acme/utils:@stable; fi"
]
}
}
实际使用更推荐轻量方案：
- CI 脚本里先
sed -i '/path/d' composer.json清掉本地仓库，再composer install - 本地开发用别名：alias ci-install='sed -i "/path/d" composer.json && composer install'
- 永远别把
path仓库提交到主干分支——它只该存在于feature/*或本地.gitignore临时分支里
最易忽略的一点：path 依赖默认创建 symlink，但 Windows 默认禁用开发者模式时会失败，报 symlink(): Operation not permitted。此时得在 config 里显式关掉："symlink": false，否则整个 install 卡住不动。
