Invalid target path for symlink 错误源于 Composer 解析 path 仓库 url 字段时路径校验失败，非权限问题；需确保 url 为绝对或项目内相对路径（禁用 ~/$HOME）、目标目录真实存在且含有效 composer.json、name 字段与 require 完全一致、symlinks:true 置于 repositories 的 path 条目内，并清除 vendor 和 composer.lock 后执行 --prefer-source 重装。
Invalid target path for symlink 不是权限问题
这个报错根本没走到创建软链接那步，是 Composer 在解析 repositories 里 path 类型的 url 字段时直接拒绝了路径格式。它不会调用 ln -s，也不检查你有没有管理员权限或 Windows 开发者模式——那些场景报的是 Failed to create symbolic link 或 Permission denied。
url 值含 ~ 或 $HOME 就会失败
Composer 对 url 字段做严格校验，只接受绝对路径（如 /home/user/my-pkg）或项目根目录相对路径（如 ../my-pkg），明确禁用 ~、$HOME、环境变量展开等写法。
-
"url": "~/my-pkg"→ 必须改为"url": "/home/yourname/my-pkg"或"url": "../my-pkg" -
"url": "${HOME}/my-pkg"→ 同样非法，PHP 不做 shell 展开 - 目标路径本身是符号链接（例如
../my-pkg → /tmp/real-pkg）→ Composer 不解析嵌套软链，必须指向真实目录
本地包 composer.json 必须完全合规
即使路径对了，composer.json 里一个字符错位也会触发该错误。关键字段必须逐字匹配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
name字段大小写、分隔符、末尾斜杠都必须和主项目require中声明的字符串完全一致。比如"acme/utils": "*"要求本地包name是"acme/utils"，不是"Acme/utils"、"acme-utils"或"acme/utils/" - 目标目录必须真实存在，且含语法正确的
composer.json（可用composer validate ../my-pkg/composer.json验证） - 本地包自身需声明
"options": {"symlink": true}，否则 symlink 不生效
symlinks: true 必须放在正确位置
这个配置项必须写在 repositories 数组中对应 path 条目的对象内，不能放在顶层 config 段里——否则完全被忽略。
正确写法示例：
{
"repositories": [
{
"type": "path",
"url": "../my-pkg",
"symlinks": true
}
]
}
修复后务必删掉 vendor/ 和 composer.lock，再执行 composer install --no-cache --prefer-source。最容易被忽略的是：Windows 用户路径含中文、空格或括号时，某些 PHP 版本会静默截断，导致 name 校验跳过，建议先用英文路径验证逻辑是否通。
