Invalid target path for symlink 是路径校验失败，非权限问题：路径须为绝对或相对路径（禁用~、$HOME、嵌套软链），目标目录必须真实存在且含合法composer.json，其中name字段须与require声明完全一致；"symlinks": true须置于repositories对应path仓库对象内，旧版本用"options": {"symlink": true}；需删除vendor和composer.lock后执行composer install --prefer-source重建链接。
Invalid target path for symlink 不是权限问题，是路径校验失败
这个错误不是因为没权限或 Windows 开发者模式没开，而是 Composer 在创建软链接前做了一次硬性路径校验，不通过就直接报错。它只认两种路径：绝对路径（如/home/user/my-pkg）和相对于项目根目录的相对路径（如../my-pkg）。~、$HOME、环境变量、嵌套软链接（比如../my-pkg本身是个 symlink）全都不行。
-
url字段必须指向一个真实存在的目录，且该目录下要有合法的composer.json -
composer.json里的name字段必须和主项目require中声明的**完全一致**（大小写、vendor 名都不能差） -
"symlinks": true必须写在repositories里对应的那个path仓库对象内部，不能塞进config段 - Composer 2.2+ 才支持
symlinks字段；旧版本得用"options": {"symlink": true}，混用会失效
vendor 目录残留会让 symlink 配置彻底失效
即使所有配置都对，composer install也不会重建软链接——它只按composer.lock还原。如果上次是复制安装，这次照样复制，根本不会触发 symlink 创建逻辑。
- 必须先删掉整个
vendor/目录和composer.lock - VS Code 内置终端要彻底退出（不只是重启 pane），避免复用旧 shell 环境变量
- 运行
composer install --no-cache --prefer-source，强制走 source 模式并尝试建链 - 验证是否成功：
ls -la vendor/acme/utils，看到-> ../my-pkg才是真链接
中文路径或 WSL drvfs 分区导致 symlink 静默降级为 copy
Windows + WSL 或中文路径下，PHP 的symlink()函数会静默失败，Composer 就自动 fallback 到 copy 模式，但不会报错——你只看到 vendor 里多了个普通文件夹，而不是链接。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
COMPOSER_HOME必须设为英文路径（如/home/user/composer），否则全局配置可能被中文污染 - 项目
composer.json里加"config": {"bin-compat": "full", "use-symlinks": true} - 项目必须放在 WSL 原生 ext4 分区（如
/home/xxx/project），不能放/mnt/c/xxx这种 drvfs 挂载点 - 如果非得放 Windows 盘，每次
composer install后手动补权限：chmod +x vendor/bin/* 2>/dev/null || true
执行目录错位也会触发“路径无效”类报错
报错里写的路径就是pwd输出的位置，不是你“以为”的位置。尤其在 monorepo、容器、VS Code Remote-SSH 场景下，pwd 显示的路径和实际文件位置常不一致。
- 执行前必跑
pwd和ls -l composer.json确认当前目录和文件存在 - 用
-d参数时，必须写在子命令前：composer -d ./api install，不能写成composer install -d ./api -
composer.json不能是 UTF-8 with BOM 编码（记事本默认保存格式），用file -i composer.json检查 - 目录是软链接时，某些 CI 或容器环境禁止跨挂载点访问，
realpath()失败会导致“找不到文件”假象
真正卡住的点往往不在配置本身，而在路径的“真实性”和“可见性”——Composer 对路径的校验比人眼严格得多，少一个斜杠、多一个波浪号、甚至目录名里有个中文字符，都会让 symlink 创建流程在第一关就终止。
