composer link 不能批量运行，因其必须在每个本地包目录内执行以注册链接，再回主项目调用带包名参数的命令才生效；批量需脚本封装或改用 path 仓库配合 symlink 模式。
Composer 本身不支持“批量添加软链接”，composer link 只能对单个已安装包生效，且必须在该包源码目录内执行；所谓“批量”，只能靠脚本封装或结构化设计实现。
为什么 composer link 不能直接批量运行
这个命令本质是「在当前目录（即本地包源码根目录）生成一个 vendor 符号链接注册信息」，然后回主项目执行一次 composer link vendor/name 才真正生效。它不是 Composer 的全局命令，也不读取配置列表。
- 必须先进入每个本地包目录才能运行
composer link，否则报错Could not find package.json或No composer.json found - 如果包还没被
composer require过，composer link会静默失败，不报错也不创建链接 - 多个包共用同一 vendor 名称前缀时（如
myorg/foo、myorg/bar），必须逐个指定全名，不能用通配符
用 path 仓库 + composer update 替代手动 link
这是更稳定、可复现的多模块方案，适合 modules/ 下有多个本地包的场景。不需要进子目录，也不依赖 composer link。
- 在主项目
composer.json的repositories中一次性声明所有路径：
"repositories": [
{ "type": "path", "url": "modules/user" },
{ "type": "path", "url": "modules/payment" },
{ "type": "path", "url": "modules/notification" }
]
-
require块里写明各包名和分支（如"myorg/user": "dev-main"），注意必须用dev-开头的开发分支名，不能写*或^1.0 - 运行
composer update myorg/user myorg/payment myorg/notification—— 明确列出包名，避免误更新其他依赖 - 完成后，
vendor/myorg/user等目录会自动变成指向对应modules/xxx的符号链接（前提是启用了path仓库的 symlink 模式）
如何让 path 仓库真正生成软链接而非复制
默认情况下，path 类型仓库会把本地目录「复制」进 vendor/，这在开发中毫无意义。必须显式开启 symlink 模式：
- 在主项目根目录执行：
composer config --local repositories.my-path.type path（仅当用命名仓库时需要） - 更通用的做法：在
composer.json的config块加这一行：
"config": {
"preferred-install": { "myorg/*": "source" },
"sort-packages": true
}
-
"source"表示对匹配myorg/*的所有包，强制走源码模式（即 symlink），而不是 dist zip 包 - 若仍被复制，检查目标模块目录下是否有合法
composer.json，且其中name字段与require中声明的完全一致（包括大小写）
脚本化批量 link 的边界条件
如果你坚持用 composer link，唯一可行的“批量”方式是写 shell 脚本，但必须满足三个前提：
- 所有本地包已通过
composer require安装过（哪怕只是临时装再删掉） - 每个包目录下都有
composer.json，且name字段正确 - 你有权限在这些目录中执行
composer link（需 Composer 2.4+ 或已安装composer-plugin-link）
示例脚本逻辑（放在主项目根目录运行）：
for dir in modules/*; do [ -d "$dir" ] || continue cd "$dir" && composer link && cd - > /dev/null done composer link myorg/user myorg/payment myorg/notification
最后一行不可省——composer link 在子目录里只注册，真正创建符号链接要回到主项目再调一次带参数的命令。
最容易被忽略的是 autoload 同步：即使链接成功，如果子模块的 composer.json 里没配 autoload 或 autoload-dev，主项目依然 Class not found。每个模块都得自己管好 PSR-4 映射。
