target-dir 在 composer 2.x 中已被彻底删除，运行 composer install 会直接报错“invalid argument: target-dir is not supported anymore”；它仅用于旧版 psr-0 时代定位包内子目录，不控制外部安装路径，迁移时应直接删除并改用 psr-4 或 classmap。
target-dir 在 Composer 2.x 中根本不会生效
它不是“不推荐”，而是被彻底删除：任何含 target-dir 的 composer.json 在 Composer 2.0+ 下运行 composer install 会直接报错：Invalid argument: target-dir is not supported anymore。这不是警告，是硬性拒绝执行。即使你降级到 Composer 1.10.x，该字段也仅在极少数历史路径中被静默忽略，不再影响安装行为。
为什么旧项目里还留着 target-dir？
常见于 2015 年前后发布的包，当时 PSR-4 尚未普及，target-dir 被用来告诉 Composer：“这个包解压后，真正要加载的代码在 src/ 这个子目录下”。但它只参与解压阶段，不参与自动加载——加载仍靠 psr-0 或 classmap。现在所有现代加载逻辑都由 autoload.ps4 或 autoload.classmap 承担，target-dir 已无存在意义。
迁移时怎么处理残留的 target-dir 字段？
直接删掉，别试图“兼容”它：
- 打开
composer.json，删除整个"target-dir": "xxx"行（包括逗号） - 检查
autoload部分是否已用psr-4正确映射命名空间到路径，例如："MyOrg\Lib\": "src/" - 确保命名空间末尾带反斜杠
\，路径值是相对于包根目录的相对路径，不加前导/ - 运行
composer dump-autoload重建自动加载映射
如果旧项目结构混乱（比如类文件散落在 lib/、includes/），优先用 classmap 兜底："autoload": { "classmap": ["lib/", "includes/"] }，比强行改命名空间更实际。
想把包装到非 vendor 目录？别碰 target-dir
target-dir 从来就不能控制外部安装路径。它只管包内子目录定位。真要改安装位置，只有三种可行方式：
- 全局改
vendor-dir：在composer.json里加"config": { "vendor-dir": "lib/vendor" } - 对特定包软链：用
post-install-cmd脚本把vendor/foo/bar链到public/assets/foo - 用
path类型仓库：本地开发时指向真实目录，避免反复安装
记住：Composer 的物理安装路径由 name 字段严格决定，vendor/{vendor}/{name} 是铁律。任何想靠配置“绕过”它的尝试，最终都会卡在 autoload 或路径解析上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
