Composer install 默认对 path 仓库执行硬拷贝，必须在 repositories 中为该包显式配置 "options": {"symlink": true} 才启用符号链接，且需确保 composer.lock 中 source.type 为 path，否则仍走远程或复制模式。
composer install 时如何让本地包走 symlink 而不是拷贝
默认情况下，composer install 对 path 类型仓库的包会直接复制文件（copy），即使你希望它像开发时那样用符号链接。关键在于：必须显式启用 symlink 模式，且仅对 path 类型仓库生效。
实操上分两步：一是在 repositories 中声明本地路径仓库并设 "type": "path"；二是在该仓库配置里加 "options": {"symlink": true}。否则 Composer 完全忽略 symlink 请求。
-
repositories必须是数组，且每个path项需独立配置options - 路径值支持通配符（如
../packages/my-*），但匹配到多个包时，每个都会被 symlink —— 注意别意外 link 到非目标目录 - Windows 下需管理员权限或启用了开发者模式，否则
mklink失败，Composer 会退回到 copy 并静默警告（不报错） - 如果已执行过
install且目标目录存在，Composer 不会自动替换为 symlink，需先composer remove vendor/package-name或删掉vendor/后重装
为什么 composer require 后没生成 symlink
常见现象：执行 composer require myorg/mypackage:dev-main 后，vendor/myorg/mypackage 是完整副本，不是链接。根本原因是：require 命令本身不触发 symlink 逻辑，它只按当前 composer.json 的仓库配置来解析依赖 —— 如果此时还没在 repositories 里声明该包的 path + symlink: true，Composer 就只能从 Packagist 或其他远程源拉取，自然不可能 symlink。
正确流程是：先改好根目录 composer.json 的 repositories，再运行 composer require；或者先 composer install（已有 lock 文件且含本地包），再手动修改 repositories 并执行 composer update myorg/mypackage 强制重新解析。
- 修改
repositories后，必须确保composer.lock中对应包的source.type变为path，否则仍走远程 - 运行
composer update时加--with-dependencies可避免子依赖被意外降级 - 若包已存在于
vendor/，update默认复用现有安装方式（copy/symlink），需加--prefer-source配合symlink: true才能强制重建链接
symlink 模式下怎么处理 autoload 和修改实时生效
启用 symlink 后，vendor/myorg/mypackage 实际指向你的本地源码目录，因此所有文件修改立即可见，无需重复 composer dump-autoload。但前提是：你的包 composer.json 中的 autoload 字段（如 "psr-4"）路径是相对于包根目录的，且未使用硬编码绝对路径。
典型坑点是：有些包在 autoload 里写 "My\Ns\": "src/"，这没问题；但如果写成 "My\Ns\": "/full/path/to/src/"，Composer 会尝试加载不存在的绝对路径，报 Class not found。
- 检查 symlink 是否成功：运行
ls -la vendor/myorg/mypackage，输出应类似mypackage -> /absolute/path/to/local/mypackage - autoload 生效依赖于 Composer 的 autoloader 缓存，修改包内类名或命名空间后，需运行
composer dump-autoload（仅一次，后续改代码不用） - 若用 IDE（如 PHPStorm），可能需要手动刷新项目，否则无法跳转到 symlink 源码
Windows 上 symlink 失败的几个具体表现和对策
Windows 用户最常遇到的是：明明写了 "symlink": true，但 vendor/ 下仍是复制出来的文件，且控制台无任何错误提示。这是因为 Composer 在 Windows 上调用 mklink 失败时默认静默 fallback 到 copy。
验证是否真失败：打开命令行，手动执行 mklink /D C:project endormyorgmypackage C:devmypackage，看是否提示“拒绝访问”或“不支持的命令”。前者说明权限不足，后者说明未启用开发者模式或系统版本太低（Win10 1703+ 才原生支持普通用户创建符号链接）。
- 临时解决：以管理员身份运行终端再执行
composer install - 长期方案：在 Windows 设置 → “开发者选项”中开启“开发人员模式”
- 替代方案：改用
junction（仅限目录，兼容旧系统），但需自行 patch Composer 或用第三方插件（如hirak/prestissimo不支持此场景） - CI/CD 场景下，建议直接禁用 symlink（设
"symlink": false），避免环境差异引发构建不一致
实际项目里，symlink 最容易被忽略的其实是 lock 文件的同步状态——改了 repositories 却忘了 commit composer.lock，导致队友 git pull 后 composer install 依然走远程源。
