composer path仓库默认使用symlink是设计使然，可通过repositories中options.symlink=false或环境变量composer_disable_path_repo_symlinks禁用，改用copy模式；需注意autoload-dev副作用及源副本同步问题。
Composer 的 path 仓库默认会创建 symlink（符号链接），无法“关闭”该行为——但你可以通过修改仓库配置或项目配置，强制让 Composer 放弃 symlink、改用 copy 模式。
为什么 path 仓库总在建 symlink？
这是 Composer 的默认策略：当本地 path 仓库满足「可写 + 同一文件系统 + 支持 symlink」时，它优先用 symlink 加速开发。这不是 bug，是设计使然。你看到的 vendor/foo/bar 指向源目录，就是它生效了。
常见错误现象包括：
- 部署到容器或 Windows WSL2 时，symlink 失效或权限报错
-
composer install --no-dev后 symlink 仍存在，但实际代码没更新 - CI 环境中因
proc_open权限限制，symlink 创建失败却无明确提示
用 options.symlink 显式禁用 symlink
在 composer.json 的 repositories 配置中，为每个 path 类型仓库添加 "options": {"symlink": false}。这是最直接有效的控制方式。
示例：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package",
"options": {
"symlink": false
}
}
]
}
注意：
-
options.symlink必须写在具体path仓库对象内，不能放在根级config中 - 设为
false后，Composer 会改用copy模式：每次composer update或install都复制整个包目录（含.git等隐藏文件） - 若源路径含未提交的 Git 修改，copy 模式会保留这些变更；symlink 模式则实时反映源目录状态
全局 fallback：用 COMPOSER_DISABLE_PATH_REPO_SYMLINKS 环境变量
适用于 CI/CD 或临时调试场景，无需改项目配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
执行命令前设置环境变量即可：
COMPOSER_DISABLE_PATH_REPO_SYMLINKS=1 composer install
或在 Linux/macOS 中导出：
export COMPOSER_DISABLE_PATH_REPO_SYMLINKS=1 composer update
Windows cmd 下用：
set COMPOSER_DISABLE_PATH_REPO_SYMLINKS=1 && composer install
这个变量会覆盖所有 path 仓库的 symlink 行为，但不会影响其他仓库类型（如 vcs）。
别漏掉 config.autoload-dev 和 autoload 的副作用
即使禁用了 symlink，如果本地包的 autoload-dev 包含了项目根目录下的测试文件（比如 tests/），而你的主项目又启用了 autoload-dev，Composer 可能仍会把那些路径加入自动加载器——造成意外交互。
建议检查并清理：
- 本地包的
composer.json中autoload-dev是否过度宽泛 - 主项目是否误启用了
"optimize-autoloader": true，导致 dev autoload 被忽略（这会让 copy 后的测试类不可用） - 运行
composer dump-autoload -o前确认autoload-dev是否应被包含
真正麻烦的不是 symlink 开关本身，而是 copy 模式下源与副本的状态同步——改了本地包代码却不 composer update，就等于在用旧快照。这点容易被忽略。
