path仓库必须写在项目根composer.json的repositories顶层数组中，且需配置"type":"path"和指向含composer.json目录的url；require包名须与本地包name完全一致，执行composer update而非install才能重建symlink。
path仓库必须写在项目根composer.json里
Composer 的 path 类型仓库不是全局开关，也不是插件功能，它只在你当前项目的 composer.json 文件中声明时才生效。写错位置（比如写进本地包自己的 composer.json）完全无效。
正确做法是：打开项目根目录下的 composer.json，确保 repositories 是顶层字段，且每个项包含 "type": "path" 和合法的 "url"：
{
"repositories": [
{
"type": "path",
"url": "../my-utils"
}
],
"require": {
"acme/utils": "dev-main"
}
}
注意三点：
-
url必须指向一个**目录**，不能是../my-utils/composer.json - 该目录下必须存在
composer.json，且其中"name"（如"acme/utils"）和"version"（哪怕写"dev-main"）与require中完全一致 - 路径支持相对路径（推荐）或绝对路径，但不能含
~、环境变量或未转义的 Windows 盘符冒号（如C:\pkg要写成C:/pkg或双反斜杠）
为什么 vendor 里是符号链接而不是复制文件
这是 path 仓库的预期行为，不是 bug，本质是“热更新”机制：你改本地包代码，主项目立刻可见，不用重复安装。
是否成功创建符号链接，取决于三个条件：
- 操作系统支持
symlink()（Linux/macOS 默认 OK；Windows 需开启“开发者模式”+以管理员身份运行终端） - 本地包的
composer.json中没显式声明"type": "dist" - 你执行的是
composer update acme/utils，而不是composer install（后者不刷新已有链接）
验证方式：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS：
ls -la vendor/acme/utils，输出含-> ../my-utils才对 - Windows：
dir vendor\acme\utils，看到<symlinkd></symlinkd>表示成功
改了本地包代码，为什么 composer install 不生效
composer install 只负责按 composer.lock 还原依赖状态，它不会重新解析 repositories 或重建符号链接目标。哪怕你把 ../my-utils 里的代码全删了，install 也照常完成——因为它根本不检查源路径内容。
真正触发链接重建的操作只有两个：
-
composer update acme/utils—— 推荐，精准、安全、快 -
composer update（不带参数）—— 全量重算，可能意外升级其他包，慎用
常见错误操作：
- 以为
composer dump-autoload能刷新链接（它只更新类映射） - 手动在
vendor/下建软链或复制（会干扰 Composer 自身管理，导致后续update失败） - 没确认本地包已执行过
git init并至少有一次 commit（Composer 某些版本会静默跳过未初始化的 Git 目录）
CI/CD 环境中符号链接必然失败
生产构建、Docker 构建或 GitHub Actions 等场景，../my-utils 路径大概率不存在，符号链接会断开，导致运行时报错 Class not found 或 failed to open stream。
上线前必须清理掉 path 仓库配置：
- 临时方案：运行
composer config --unset repositories.my-local-path删除项目级配置 - 稳妥方案：在 CI 脚本开头先
sed -i '/"type": "path"/,+2d' composer.json（Linux/macOS）或用 PowerShell 替换，再执行composer install - 绝对不要把
repositories块留在正式发布的composer.json中
符号链接是开发期的便利机制，它的脆弱性恰恰提醒你：本地调试通过 ≠ 依赖可发布。真要上线，本地包得先打 tag、推到私有仓库或 Packagist，再改回稳定版本约束。
