Composer在本地开发时通过path类型仓库自动或强制使用符号链接，满足条件即创建软链实现文件实时同步，提升调试效率。
Composer 在处理符号链接（symlink）的包时，主要出现在开发过程中，特别是当你使用 本地路径仓库（如 `path` 类型的仓库）来引用一个在本地开发的包时。这种情况下，Composer 可能会创建符号链接而不是复制文件，从而提升性能并方便实时调试。
何时会使用符号链接？
当通过 composer.json 配置了一个本地路径类型的仓库，并且满足一定条件时，Composer 会自动尝试使用符号链接：
- 目标包位于本地文件系统中（例如：../my-package）
- 操作系统支持符号链接（Linux/macOS 支持良好，Windows 需管理员权限或开发者模式）
- 配置了
"symlink": true或未设置但符合自动判断逻辑
如何强制使用符号链接？
在主项目的 composer.json 中定义本地包时，可以明确指定 "symlink": true：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package",
"options": {
"symlink": true
}
}
],
"require": {
"my-vendor/my-local-package": "*"
}
}
这样 Composer 安装时就会尝试创建符号链接。若无法创建（如权限不足），则退回到复制方式。
符号链接的实际效果
一旦成功，你在 vendor/ 目录下看到的包实际上是一个指向原始目录的软链：
- 修改源码（在 ../my-local-package）会立即反映在 vendor 中
- 无需重复运行
composer install来同步代码 - 适合边开发边测试的场景
注意事项与常见问题
符号链接虽方便，但也有一些限制：
- 跨驱动器不支持：Windows 上从 C: 到 D: 盘通常无法创建符号链接
- 权限问题：某些系统需特殊权限才能创建 symlink
- Docker 或 CI 环境中可能失效：容器内挂载时需确保宿主机已正确建立链接
- Git 不保存 symlink 指向的内容：提交的是链接本身，不是源文件
可以通过命令查看是否为符号链接：
ls -la vendor/my-vendor/my-local-package
输出中若显示 -> ../my-local-package 表示是符号链接。
