composer默认对path仓库使用软链接以支持快速迭代，但docker、ci等场景需禁用；可靠方式有三：项目级配置"symlink": false、全局composer config --global symlinks false、单次命令--no-symlinks。

为什么 composer install 会用软链接而不是复制本地仓库

Composer 默认对 path 类型仓库（如 "type": "path"）启用软链接（symlink），前提是当前系统支持且目标路径可写。这是为了快速迭代：改源码、composer install 不重拷，直接生效。但软链接在某些场景下会出问题——比如 Docker 构建时宿主机 symlink 在容器内失效、CI 环境无权限创建链接、或部署后需要完全隔离依赖副本。

强制关闭 symlink 的三种有效方式

关键不是“删掉软链接再复制”，而是让 Composer 根本不走 symlink 流程。有且仅有以下三种可靠方法，按优先级排列：

• 在项目根目录的 composer.json 中添加：

  "config": {
    "symlink": false
  }

• 全局禁用（影响所有项目）：composer config --global symlinks false
• 单次命令禁用：composer install --no-symlinks 或 composer update --no-symlinks

注意："symlink": false 是布尔值，不是字符串 "false"；写错会导致配置被忽略，仍走 symlink。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

执行后仍看到软链接？检查这些隐藏坑

即使配置正确，旧 symlink 可能残留并干扰新行为：

• 先手动删掉 vendor/ 下已存在的软链接目录（如 vendor/my/local-package），再运行 composer install
• 确认没有在父目录或 home 目录存在更高优先级的 composer.json 配置覆盖了当前项目的 "symlink": false
• 如果用了 path 仓库并设置了 "options": {"symlink": true}，这个包级配置会覆盖全局/项目级配置，必须删掉或设为 false
• Docker 构建中，确保 composer install 执行时工作目录是项目根，且 vendor/ 未被 volume 覆盖或缓存

复制模式下的路径与性能影响

关闭 symlink 后，Composer 会完整拷贝整个 path 目录内容到 vendor/，这意味着：

• 每次 composer install 或 update 都触发文件复制，大仓库（如含 node_modules 或大量测试资产）会明显变慢
• vendor/ 中的包不再反映源目录实时变更，改本地代码必须重新 composer update 才生效
• 源目录中的 .git、README.md 等非 PHP 文件也会被复制进去（Composer 不过滤），可能增大部署体积
• 若源路径是相对路径（如 ../my-package），复制后与原路径彻底解耦，移动项目不会意外带偏依赖

真正要切换模式时，别只改配置——先清 vendor，再验证是否生成的是真实目录而非残留链接，否则你会以为改成功了，其实还在用 symlink。