composer v2.0 已彻底移除 target-dir 配置项，因其与 PSR-4 不兼容、破坏命名空间映射关系且不支持多命名空间；应改用 PSR-4（推荐）或 classmap 替代，并更新 autoload 配置及命名空间声明。
Composer 已在 v2.0 中完全移除了 target-dir 配置项，它从 v1.10 开始被标记为废弃（deprecated），并在后续版本中彻底删除。因此，当前版本的 Composer 不再解析或处理 target-dir，任何在 composer.json 中声明的该字段都会被忽略，且运行 composer install 或 composer update 时可能触发警告（v1.x 后期）或直接报错（取决于严格模式和 Composer 版本）。
为什么 target-dir 被废弃？
该配置原本用于将包内某子目录映射为根命名空间（例如把 src/http/ 映射到 MyVendorPackage），但实际带来了多个问题：
- 与 PSR-4 自动加载标准不兼容，容易引发类路径混乱和自动加载失败
- 破坏了“目录即命名空间”的直观映射关系，增加维护成本
- 无法支持多命名空间共存，灵活性差
- Composer 自身的 autoloader 优化（如 classmap 生成、静态分析）难以适配该机制
替代方案：用 PSR-4（推荐）或 classmap
迁移只需调整 autoload 配置，无需修改文件结构：
- PSR-4 是首选：明确声明命名空间前缀与目录的对应关系
例：把原"target-dir": "src/"改为"autoload": { "psr-4": { "MyVendorPackage": "src/" } } - classmap 适用于非标准结构：当类文件不严格遵循命名空间路径时可用
"autoload": { "classmap": ["src/"] }
升级时要注意什么？
如果你还在用含 target-dir 的旧包（尤其是私有或遗留包）：
- 更新其
composer.json，替换为 PSR-4 或 classmap 配置 - 确认源码中类的命名空间声明与新配置一致（例如
src/Client.php应声明Namespace MyVendorPackage;） - 运行
composer dump-autoload重新生成自动加载文件 - 若使用 Composer v1.x，建议尽快升级到 v2+ 并清理所有
target-dir
基本上就这些。target-dir 是一个已被淘汰的历史机制，现代项目应完全依赖 PSR-4 或 classmap 实现自动加载 —— 更清晰、更可靠、也更符合生态惯例。
以上就是Composer 是如何处理 autoload 中的 target-dir 配置的？（已废弃）的详细内容，更多请关注php中文网其它相关文章！