windows下composer path仓库不生成软链接，主因是未在repositories中为path仓库显式配置"symlinks": true、目标路径不存在或composer.json包名不匹配、开发者模式未启用或终端非管理员权限，且需手动清理vendor和composer.lock后加--prefer-source重装。
Windows 下 composer install 在镜像源环境下仍无法创建软链接，不是镜像的问题，而是符号链接权限、路径解析逻辑和 vendor 目录所有权三者在跨系统场景下发生了隐性冲突。
Windows 启用开发者模式后仍报 symlink 错误？清缓存再重装
启用开发者模式只是开了权限开关，但 Composer 会复用旧的 vendor/ 和 composer.lock 中残留的非符号链接状态（比如上次 fallback 成复制目录），导致它跳过重建链接逻辑。
- 必须手动删掉整个
vendor/目录和composer.lock文件 - 确认终端是全新启动的（VS Code 内置终端也要关掉重开，不能只重启 shell）
- 运行
composer install --no-cache，避免从损坏缓存中恢复 dist 包 - 如果项目用了 path 类型仓库，加
--prefer-source强制走 git clone，确保链接能被识别
Linux/macOS 上镜像源 + path 仓库不生成软链接？检查 repositories 配置位置
"symlinks": true 必须写在 repositories 数组里对应那个 path 仓库的对象内部，写在根 config 或全局配置里完全无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误写法：
{"config": {"symlinks": true}}—— 这个字段根本不会被读取 - 正确写法：
{"repositories": [{"type": "path", "url": "../my-pkg", "symlinks": true}]} - 路径必须是相对或绝对路径，
~/my-pkg或$HOME/my-pkg会被忽略，直接 fallback 到复制 - 目标目录里的
composer.json的name字段必须和require中声明的完全一致（包括大小写）
Docker 或 WSL2 中 vendor 软链接失效？别混用 Windows 主机路径
在 WSL2 或 Docker 容器里执行 composer install，如果 vendor/ 挂载自 Windows 主机（如 /mnt/c/dev/project），那么即使系统支持 symlinks，Windows 文件系统（NTFS）对 Linux 符号链接的解释也不一致，会导致 bin 脚本指向错误或 require 失败。
- 开发时尽量把项目放在 WSL2 原生文件系统下（如
~/project），而非/mnt/下 - Docker 中不要用
volume把 Windows 路径挂进容器去跑composer install - CI/CD 流水线里若用 GitHub Actions 的
ubuntu-latest，确保 checkout 后直接在 Linux 环境下执行，别用setup-php插件配合 Windows runner - 实在要跨系统协作，统一用
--no-bin-links，然后手动补vendor/bin下的包装脚本（比如用php ../vendor/autoload.php启动）
最易被忽略的是：软链接是否生效，和镜像源地址本身无关；但镜像源若配置成 repos.packagist.org（带 .org），而你实际设的是 repo.packagist（无 .org），Composer 就会静默 fallback 到官方源，此时 path 仓库的 symlinks 配置可能被绕过——务必用 composer config -g repo.packagist 确认输出的是你设的镜像 URL。
