默认行为是复制文件而非创建符号链接，这是composer为保障构建可重现性采取的保守设计；必须显式配置"symlink": true、环境支持且执行composer update或--prefer-source才可能启用软链。
为什么composer install后vendor/里不是符号链接
默认行为就是复制文件，不是创建软链接——这是 Composer 为保证可重现性做的保守选择。只有明确告诉它“我要 symlink”，且环境支持，它才可能链接。很多人以为配了 "type": "path" 就自动软链，其实不然。
关键判断点：ls -la vendor/vendor/name（Linux/macOS）或 dir vendor\vendor\name（Windows）输出中必须含 -> 或标记为 <symlink></symlink>，否则就是复制模式。
- 路径仓库本身不触发 symlink，必须显式启用
-
symlinks: true必须写在repositories的对应 path 条目里，不能塞进config段 - Composer 2.2+ 才支持
symlinks: true；旧版得用"options": {"symlink": true} - 即使配置正确，若
composer.lock里记录的是 dist 模式，composer install不会改链——必须删 lock 文件重来
Invalid target path for symlink 错误的硬性校验条件
这个报错不是权限问题，是 Composer 在解析阶段就拒绝了路径，压根没走到创建环节。它只接受两类路径写法：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 绝对路径：如
"url": "/home/user/my-pkg"（不能含~或$HOME） - 项目根目录起算的相对路径：如
"url": "../my-pkg"（注意：该目录必须真实存在，且不能是另一个软链接） -
name字段必须与require中完全一致——大小写、vendor 名、斜杠、末尾空格，全要对得上 - 目标目录下必须有语法合法、非空的
composer.json，且含name和version（哪怕写"dev-main"）
强制复制而非链接的配置方式
有些场景你就是不想 symlink：CI/CD 构建、Windows 权限受限、或团队协作要求 vendor 可独立分发。这时得主动禁用链接：
- 在对应 path 仓库条目中加
"options": {"symlink": false} - 或全局设
"preferred-install": {"vendor/name": "dist"}（写进config段） - 注意：
"preferred-install": "dist"是全局开关，会影响所有包；精准控制请用键值对形式 - 改完必须删掉
vendor和composer.lock，再跑composer install --no-cache --prefer-source
本地改代码后composer install不刷新链接怎么办
composer install 从不更新已有链接的目标路径，它只补缺失项。你改了本地包代码，项目里却没生效？不是缓存问题，是根本没重建链接。
- 必须运行
composer update vendor/name，让 Composer 重新解析 path、校验 name、重建 symlink - 不要全量
composer update，避免意外升级其他依赖 - 如果本地包改了分支名（比如从
main改成develop），require里的版本约束也得同步改成"dev-develop" - 验证是否真生效：进
vendor/vendor/name目录，改个文件，立刻在主项目里var_dump看效果——别只信ls -l
最常被忽略的一点：符号链接是否生效，和 composer dump-autoload 完全无关。后者只刷新类加载映射，不碰文件系统链接。只要 vendor/ 下是真实软链，改本地代码就立刻可见——前提是 PHP 进程没 opcache 缓存脚本内容。
