解决Composer库软连接（Symlink）在Windows环境下的兼容性-composer-PHP中文网

根本原因是windows默认禁用符号链接权限，需启用开发者模式或以管理员身份运行终端；同时"symlinks": true必须写在repositories中对应path仓库的对象内，而非config或根节点，否则无效。

解决composer库软连接（symlink）在windows环境下的兼容性

Windows下symlink创建失败的真正原因不是配置错

根本原因是系统级限制：默认情况下，CMD/PowerShell 没有权限创建符号链接，Composer 会静默 fallback 到复制模式——你看到 vendor/vendor/name 是普通文件夹，不是链接，且没有任何报错提示。

必须以管理员身份运行终端（CMD/PowerShell），或启用“开发者模式”（Settings > Update & Security > For developers > Developer mode）
WSL 环境下若项目路径在 /mnt/c/，symlink 可能被禁用；建议把代码放在 WSL 原生路径（如 ~/projects/）
某些 CI/CD 工具（如 GitHub Actions 的 Windows runner）默认不启用 symlink 支持，需显式设置 shell: pwsh -Command 并确认策略允许

composer.json里symlink选项该写在哪

必须写在 repositories 条目的 options 下，不是 config，也不是本地包自己的 composer.json。写错位置等于没开。

Discussion Composer

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

下载

正确位置：

{
  "repositories": [
    {
      "type": "path",
      "url": "../my-package",
      "options": {
        "symlink": true
      }
    }
  ]
}

"symlink": true 必须是布尔值 true，不是字符串 "true"，否则被忽略
路径不能以 ./ 开头（Composer 不解析），推荐用 ../my-package 或绝对路径（如 C:/dev/my-package，注意用正斜杠 / 或双反斜杠 \）

为什么改了本地包代码，vendor里还是旧逻辑

因为 symlink 只是文件系统指针，不触发 autoloader 重生成。IDE 缓存、OPcache、autoload 映射未更新都会导致“改了没反应”。

执行 composer dump-autoload -o（加 -o 强制优化 autoload），否则新类/命名空间不会被扫描到
PHP CLI 和 Web Server（如 Apache/Nginx）可能使用不同 OPcache 实例，需分别清理：php -r "opcache_reset();" 或重启服务
IDE（如 PHPStorm）可能缓存了 symlink 目标路径，改源码后仍提示 “class not found”，需手动触发索引重建（File > Reload project from disk）

CI/部署脚本里千万别留symlink配置

CI 构建和线上环境必须禁用 symlink——它依赖本地路径存在、权限可控、文件系统支持 follow_symlinks，这些在容器或远程服务器上极不可靠。

CI 脚本中应临时注释掉 repositories 中的 path 条目，或用 composer install --no-plugins 避免加载干扰项
生产部署前运行 composer install --no-dev --optimize-autoloader，确保所有依赖走 dist 安装，不依赖任何本地路径
若需调试，用 composer show vendor/name 检查输出中的 source 字段：出现 "type": "path" 就说明还在走本地链接，必须修复

实际生效的关键点就两个：Windows 系统权限到位 + options.symlink 写对位置。其他都是验证和兜底，别指望 Composer 自动发现你漏了哪一环。