关键在于按需切换而非共存：path仓库需置顶、本地包须有git commit，ci中必须移除；composer.lock残留会导致仍装本地包，需清空lock和vendor后重装；autoload映射需手动dump-autoload更新。
path仓库怎么让本地包和线上包共存不冲突
关键不是“同时启用”，而是“按需切换”：Composer 会按 repositories 数组顺序查找包，但 path 类型仓库只对明确出现在 require 中的包生效，且优先级高于远程源——只要配置了，它就会拦截匹配的 vendor/name，完全跳过 Packagist 或私有镜像。
常见错误现象：composer install 装的是线上版，不是你改的本地代码；或者 CI 构建失败，报 Could not find package。
- 必须把 path 条目放在
repositories数组最前面（顺序决定优先级），例如：{ "repositories": [ { "type": "path", "url": "../my-utils" }, { "type": "composer", "url": "https://your-private-mirror.com" } ] } - 本地包目录下必须有
git init且至少一个 commit，否则 Composer 拒绝加载（即使有合法composer.json） - CI/CD 环境中必须移除或注释掉 path 条目，否则构建必然失败——因为路径不存在，且 Composer 不会静默降级到远程源
- 不要在
require里混用dev-main和^2.0：同一包不能同时用开发分支和稳定版本约束，Composer 会直接报错
如何安全地在本地调试和上线部署间切换
没有“自动切换”机制，靠的是配置隔离与手动控制。核心原则是：开发时用 path，上线前回归远程源，且两者不能共存于同一份 composer.json。
推荐做法是用 Git 分支或配置文件模板管理差异：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 主分支（
main）保持 clean 的composer.json，不含任何path条目，所有包走私有镜像或 Packagist - 开发分支（
feat/local-debug）添加repositories配置，并确保composer.lock提交时包含 path 解析结果（即"type": "package"+"dist"字段为空） - 上线前执行
git checkout main && git restore composer.json composer.lock，再composer install --no-dev - 避免用
composer update覆盖线上 lock 文件——它可能悄悄把 path 包解析成远程版本，导致行为不一致
为什么删了 repositories 还是装本地包
不是配置没删干净，而是 composer.lock 里还记着上次 path 解析的结果。Composer 安装时优先读 lock 文件，只要里面存了那个包的 source 类型为 path 或 dist 指向本地路径，它就照装不误，完全忽略当前 composer.json 有没有 repositories。
验证方式：打开 composer.lock，搜索你的包名，看 "source" 字段是否含 "type": "path" 或 "url" 是本地路径。
- 彻底清除：删掉
vendor、composer.lock，再删repositories条目，最后composer install - 快速清理：运行
composer update vendor/name --with-dependencies，它会强制重新解析源，从远程拉取（前提是repositories已清空） - Windows 用户特别注意：如果之前创建过 symlink 但没权限删除，
vendor目录可能残留只读属性，导致rm -rf vendor失败，需先手动解除
symlink 生效但类找不到？autoload 没刷新
符号链接建成功 ≠ 类能自动加载。Composer 的 autoload 机制只认 vendor/composer/autoload_psr4.php 里的映射，而这个文件由 composer dump-autoload 生成，和 symlink 无关。
常见错误现象：改了本地包的 src/Helper.php，var_dump(class_exists('AcmeHelper')) 仍返回 false。
- 必须运行
composer dump-autoload（或composer install --optimize-autoloader）才能更新映射表 - 如果本地包用了 PSR-4，检查它的
composer.json是否正确声明了"autoload": {"psr-4": {"Acme\": "src/"}} - 项目级 autoload 不会自动继承本地包的 autoload 配置——每个包的 autoloading 是独立注册的，所以本地包改了 autoload 配置，必须重新 dump
- 某些 IDE（如 PHPStorm）缓存了类映射，改完后需手动 File → Reload project
