答案是：Composer原生不提供composer link命令，软链接效果主要通过path仓库类型实现，需在主项目composer.json的repositories中配置type为"path"、url为相对路径，并添加"options":{"symlink":true}，再执行composer update包名。
Composer 本身不提供 composer link 这个命令——它只在特定条件下可用，且行为高度依赖版本和插件。你看到的“软链接”效果，基本都来自 path 仓库类型或 composer-plugin-link 插件，不是开箱即用的功能。
path 仓库是创建软链接的正统方式
这是 Composer 原生支持、可复现、适合团队协作的方式。它不靠插件，也不改全局配置，只靠 composer.json 的两处改动：
- 在主项目
composer.json的repositories里加一个path类型源，url必须是相对于项目根目录的相对路径（如"../my-package"），不能是~/或绝对路径 -
require中写分支名 +@dev后缀，例如"my-vendor/my-package": "dev-main@dev"—— 缺少@dev会被忽略 - 运行
composer update my-vendor/my-package（必须带包名），完成后vendor/my-vendor/my-package就是符号链接，指向你本地目录
⚠️ 注意：path 默认是复制模式；要强制软链接，得额外加 "options": {"symlink": true} 到该 repository 配置里。
composer link 命令只对已安装包生效
这个命令不是 Composer 核心功能，而是由 composer-plugin-link 提供（Composer 2.4+ 内置兼容，但行为仍受限）：
- 必须先用
composer require vendor/name把包正常装进vendor/，否则composer link找不到目标 - 进入你本地包的根目录（即有
composer.json的那层），执行composer link - 再回到主项目目录，执行
composer link vendor/name，才会在vendor/下建软链 - 它不修改
composer.lock，也不更新 autoload 映射；下次composer update极可能把软链覆盖回普通目录
为什么 vendor 目录里没出现软链接？常见断点
软链接失败往往卡在几个确定环节：
-
composer.json中本地包的name字段和require里写的完全不一致（大小写敏感、拼写差一个字符都不行） - 本地包目录下没有合法
composer.json，或里面缺name、version字段 - 用了
composer install而不是composer update vendor/name—— 前者只认composer.lock，不会拉新配置 - PHP 进程无权限创建符号链接（Linux/macOS 默认允许，Windows 需管理员权限或启用开发者模式）
软链接 ≠ 自动加载生效
即使 vendor/ 下成功出现了软链接，类还可能报 Class not found：
- 检查本地包的
composer.json是否正确声明了autoload（如"psr-4": {"MyVendor\": "src/"}） - 主项目执行过
composer dump-autoload吗？软链接后 autoload 映射不会自动刷新 - 如果本地包改了命名空间或目录结构，必须删掉
vendor/composer/autoload_psr4.php等缓存文件再重生成
真正容易被忽略的是：软链接只是文件系统层面的映射，Composer 的自动加载机制仍然严格依赖各包自身的 autoload 配置和主项目的 autoload 重建动作——这两步漏掉任何一环，代码就跑不起来。
