target-dir 已被 Composer 官方弃用并自 2.0 版彻底移除，保留会导致安装失败；其设计初衷是适配 PSR-0，但 PSR-4 普及后失去意义；应改用 path repository 等替代方案。
target-dir 已被 Composer 官方弃用，且自 Composer 2.0 起完全移除。如果你在旧项目中看到 target-dir 配置，它不会生效，强行保留只会导致安装失败或行为不可预测。
为什么 target-dir 不再起作用
Composer 在 1.x 后期已标记 target-dir 为废弃，其设计初衷是解决早期 PSR-0 自动加载与目录结构不匹配的问题。但随着 PSR-4 成为主流、自动加载机制重构，该字段失去了存在意义。Composer 2.0 彻底删除了对它的解析逻辑。
- 运行
composer install时若composer.json中含"target-dir"字段，会直接报错：Invalid argument: target-dir is not supported anymore - 即使降级到 Composer 1.10.x，该字段也仅在极少数历史兼容路径下被忽略，不再影响实际安装位置
- 包的最终安装路径只由
vendor/下的命名空间映射（autoload）和仓库类型（path、vcs、package）决定
替代方案：用 path repository 指向本地目录
若你的真实需求是“让某个包不装进 vendor/foo/bar，而是软链接或复制到项目内特定路径（如 lib/MyLegacyLib）”，应改用 path 类型仓库 + symlink 控制。
- 在根
composer.json的repositories中添加：
{
"repositories": [
{
"type": "path",
"url": "./lib/MyLegacyLib"
}
],
"require": {
"mycompany/mylegacylib": "*"
},
"config": {
"preferred-install": { "mycompany/mylegacylib": "source" },
"autoloader-suffix": "MyLegacy"
}
}
-
./lib/MyLegacyLib/composer.json必须存在，且含合法name（如"mycompany/mylegacylib"）和autoload配置 - 默认会创建符号链接；如需复制，设
"symlink": false在该 repo 定义内 - 注意：此方式下包仍位于
vendor/，只是源来自本地路径——真正“改变安装位置”只能靠 post-install-cmd 脚本搬运，但强烈不建议
旧项目迁移时最常踩的坑
很多老项目残留 target-dir 是因为从 PEAR 或早期 Zend Framework 迁移而来，误以为它是“安装路径控制开关”。实际上：
- Composer 从不支持把包装到
vendor/外的任意位置——这是硬性限制，不是配置问题 - 若你依赖的是
pear-foo/bar这类历史包，应查找对应 Composer 包名（如phpunit/phpunit），而非试图复用旧 PEAR 目录结构 - 遇到
Class not found错误，90% 是autoload配置缺失或命名空间不匹配，不是安装路径错了 - 检查是否误将
target-dir和install-path（非标准字段，某些插件支持）混淆；后者也早已失效，且无官方支持
真正需要定制文件落点的场景极少，多数时候是自动加载没配对或对 Composer 的 vendor 隔离模型理解有偏差。删掉 target-dir，专注修好 autoload 和 repositories，比折腾路径更可靠。
