根本原因是 symlink 未生效，导致运行时加载 vendor 中的静态副本而非源码；验证需用 ls -la 或 dir 检查是否为链接，且本地包 composer.json 必须配置 "options": {"symlink": true}。
path依赖改了代码却没生效，90%是symlink没真正建立
Composer的path仓库默认尝试创建符号链接，但失败时会静默fallback到copy模式——你改的是源码目录，运行时加载的却是vendor里那份静态副本，毫无提示。
验证是否真用了symlink：
- Linux/macOS：运行
ls -la vendor/vendor/name，看到->才算成功 - Windows：运行
dir vendor endor ame，看到JUNCTION或SYMLINKD才对 - 如果显示普通文件夹，说明已fallback，立刻检查本地包根目录下的
composer.json
关键点不在主项目配置，而在于**本地包自己的 composer.json 必须包含 "options": {"symlink": true}**。漏这句，Windows即使管理员权限、Docker即使挂载目录，也必 fallback。
path仓库配置后require失败，先查这三个硬条件
Composer对path类型仓库极其严格，缺一个条件就静默跳过，连warning都不抛。
-
type字段必须显式写为"path"（不是"package"，也不能漏） -
url必须是**绝对路径**（~/、.、../全部被忽略） - 该路径下必须存在语法合法的
composer.json（无BOM、无尾逗号、全双引号）
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
realpath转成绝对路径：composer config repositories.mypkg path "$(realpath ./local-pkg)" - 路径末尾不能加
/：/home/user/pkg✅，/home/user/pkg/❌ - 验证配置是否写入：
cat ~/.composer/config.json | grep -A2 mypkg，确认输出含"type": "path"和完整绝对路径
autoload映射不更新，不是Composer没装包，而是dump-autoload没跑对
本地包的PSR-4映射不会自动继承到主项目，必须手动触发生成，且参数选错就白干。
- 改完本地包的
composer.json中autoload或autoload-dev后，必须执行composer dump-autoload - 如果新增了
autoload-dev下的类（如tests/或factories/），要加--dev：composer dump-autoload --dev - 如果移动/重命名过类文件，要用
-o强制重建classmap：composer dump-autoload -o - 上线部署时别复制vendor，必须在目标环境执行
composer install --no-dev --optimize-autoloader
检查最终映射是否生效：打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 'App\'），确认对应路径是绝对路径，且该路径下真实存在对应文件。
require命令写错版本，path包根本进不了vendor
path仓库不走稳定性过滤，但Composer仍需一个明确的解析目标；写错版本号，包压根不会被安装。
- 不能写
composer require vendor/name（无版本），Composer会按默认stable策略去“猜”，而本地包通常不满足 - 正确写法是显式指定开发分支：
composer require vendor/name:dev-main（前提是本地包composer.json里有"version": "dev-main"或当前在main分支） - 或者设
"minimum-stability": "dev"后写composer require vendor/name:@dev - 如果包只出现在
require-dev里，又执行了composer install --no-dev，它会被完全忽略，且不报错
最隐蔽的坑是版本约束冲突：本地包写 "version": "dev-main"，主项目却写 "vendor/name": "^1.0"，Composer会直接拒绝匹配——此时 composer show 都看不到这个包。
