invalid target path for symlink 错误是composer路径校验失败，非权限问题；要求url为绝对路径或项目内相对路径、symlinks:true置于repositories的path条目内、本地包composer.json需声明"options":{"symlink":true}，并清除vendor和composer.lock后重装。
软链接无法创建不是权限限制问题，是 Composer 在创建前就拒绝了非法路径——它根本没走到系统 symlink() 系统调用那步。
Invalid target path for symlink 错误到底在报什么
这个错误不是 Linux 的 Operation not permitted，也不是 Windows 的“拒绝访问”，而是 Composer 自己的路径校验失败。它只接受两类 url 值：
- 绝对路径（如
/home/user/my-pkg） - 项目根目录起始的相对路径（如
../my-pkg）
以下写法全部触发该错误：
-
"url": "~/my-pkg"（~不展开，直接被拒） -
"url": "$HOME/my-pkg"（环境变量不解析） -
"url": "/mnt/c/my-pkg"（WSL 下 drvfs 路径被主动屏蔽） -
"url": "../my-pkg -> /tmp/real"（目标本身是软链，Composer 不递归解析）
symlinks: true 必须放在对的位置
很多人把 symlinks: true 塞进 config 段或全局配置里，它完全无效。必须嵌套在 repositories 中对应那个 path 类型条目内部：
{
"repositories": [
{
"type": "path",
"url": "../my-pkg",
"symlinks": true
}
]
}
漏掉这行，或者写成：
"config": { "symlinks": true } // ❌ 无效
——Composer 就当没看见，降级为 copy。
本地包自身也要声明 symlink 支持
即使主项目配置全对，如果本地包（即 url 指向的那个目录）的 composer.json 没声明 "options": {"symlink": true}，Composer 仍会跳过软链、改用复制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确写法示例（本地包根目录下的 composer.json）：
{
"name": "acme/utils",
"autoload": { "psr-4": { "Acme\": "src/" } },
"options": {
"symlink": true
}
}
注意："options" 是顶层字段，不是 config 或 extra 的子项。
Windows WSL 和 Docker 下的特殊陷阱
在 WSL 的 /mnt/c/ 或 Docker bind mount 宿主机路径中，PHP 的 symlink() 函数会静默失败，Composer 自动 fallback 到 copy —— 你看到的 vendor/acme/utils -> ../my-pkg 其实是普通文件，只是 IDE 或 ls -la 显示错觉。
真正可靠的解法只有两个：
- 把项目移到 WSL 原生 ext4 分区（如
~/projects/myapp） - 在 Docker 中，不要在宿主机运行
composer install；改用Dockerfile内部执行：RUN composer install --prefer-source
强行在 /mnt/c/ 下启用软链，需额外加两项配置且不稳定：
"config": {
"use-symlinks": true,
"bin-compat": "full"
}
但即便如此，vendor/ 子目录里的软链仍可能失效，且每次 install 后要手动 chmod +x vendor/bin/* 才能执行。
