答案是路径校验失败，非权限问题：composer在创建软链接前严格校验url字段，须为绝对或项目内相对路径（禁用~/$home）、目标目录真实存在且含有效composer.json、name字段与require完全一致、symlinks:true置于repositories的path条目内、本地包需声明"options":{"symlink":true}，并清除vendor和composer.lock后执行composer install --no-cache --prefer-source。
Invalid target path for symlink 不是权限问题，是路径校验失败
这个报错根本不会走到创建软链接那步——Composer 在 symlink 创建前就校验 url 字段合法性，不通过直接抛错。常见原因包括：url 含 ~ 或 $HOME（必须用绝对路径或项目内相对路径）、目标目录是嵌套符号链接、composer.json 语法错误或为空、name 字段与 require 中字符串不完全一致（大小写、斜杠、尾部斜杠都不行）。
验证方法：composer validate ../my-pkg/composer.json；提取 name：grep '"name":' ../my-pkg/composer.json，再逐字符比对 require 行。
Linux/macOS 下 symlink 失败：检查归属与执行权限
即使路径合法，ls -ld ../my-pkg 输出第三列若不是当前用户（如显示 root 或 www-data），composer install 会因无读取权静默跳过链接创建。这不是警告，而是导致 vendor/autoload.php 引用失效的根源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 修复归属：
sudo chown -R $USER:$USER ../my-pkg - 确保目录可读：
chmod -R u+rx ../my-pkg - WSL2 用户注意：NTFS 挂载分区默认无执行权限，需在
/etc/wsl.conf中启用metadata=true并重启
Windows 下 symlink 创建失败：开发者模式 + 路径写法
Windows 默认禁止非管理员创建符号链接，且某些 PHP 版本对含空格、中文、括号的路径会静默截断，导致 name 校验跳过。
- 必须开启“开发者模式”（设置 → 更新与安全 → 开发者选项），或以管理员身份运行终端
-
url值避免使用单反斜杠："../my-pkg"或"..\my-pkg"可用，"..my-pkg"会出错 - 若目标在 OneDrive/Google Drive 同步文件夹内，系统策略可能拦截软链，此时应改用
"options": {"symlink": false}强制复制
symlink 生效但修改不生效：确认是否真走链接 + 手动触发更新
composer install 不重建已有软链，哪怕你挪动了源目录或改了代码。它只补缺失包，不刷新链接目标。
- 验证是否成功：
ls -la vendor/vendor/name（Linux/macOS）应含->；Windows 用dir vendor endor ame看是否为“快捷方式”类型 - 必须运行
composer update vendor/name（而非install）才能重新解析路径并重建链接 - 若已设
"symlink": true但依然复制，检查本地包自身composer.json是否声明了"options": {"symlink": true}—— 主项目配置只是开关，本地包需主动支持
composer.lock 里该包的 "source": {"type": "path"} 必须存在且未被 CI 脚本覆盖；一旦切换到生产环境，这个字段就得换成 "git" 或 "dist"，否则构建必然失败。
