target-dir 已被 composer 2.0+ 彻底移除，仅历史兼容；其设计用于 psr-0 时代解决子目录映射问题，现应统一改用 psr-4 或 classmap 实现自动加载。
target-dir 是 Composer 1.x 时代用于解决“包内主类路径与命名空间不一致”问题的临时字段，2014 年起已被弃用，Composer 2.0+ 完全移除支持，任何残留配置都会被静默忽略。
为什么曾经需要 target-dir
早期（Composer 1.0–1.4）部分包发布时，源码压缩包里实际类文件不在根目录，而是嵌套在子目录中，例如：
- 包
monolog/monolog的 zip 包解压后结构是monolog-1.25.5/src/Monolog/Logger.php - 但它的命名空间是
Monolog*，按 PSR-0 规则应从src/开始映射
当时没有 autoload.ps4 的灵活路径声明能力，target-dir 就被用来“告诉 Composer：这个包解压后，真正要加载的代码在 src/ 这个子目录下”。
它只影响安装时的解压行为，不参与自动加载逻辑——加载仍靠 psr-0 或 classmap。
target-dir 在 composer.json 中怎么写（已失效）
典型写法长这样（仅作历史参考）：
{
"name": "monolog/monolog",
"target-dir": "src",
"autoload": {
"psr-0": { "Monolog\": "src/" }
}
}
注意：target-dir 值必须是相对路径字符串（如 "src"），不能带斜杠前缀或后缀；它和 autoload.ps4 的路径声明无直接关系，也不影响 files 加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误现象：
- 升级到 Composer 2.x 后运行
composer install，包仍被装进vendor/monolog/monolog/根目录，target-dir完全没生效 - 执行
composer validate不报错，但也不会提示该字段已被废弃 - 包作者若在 2016 年后还保留此字段，说明其
composer.json长期未维护
现在应该用什么替代 target-dir
所有现代包都应通过 autoload.ps4 直接声明命名空间到路径的映射，无需中间层。例如：
"autoload": {
"psr-4": { "Monolog\": "src/" }
}
如果你正在维护一个还在用 target-dir 的旧包：
- 删掉
target-dir字段，确保autoload路径与实际文件结构对齐 - 如果源码真在子目录（如
lib/），就改"Monolog\": "lib/"，而不是靠target-dir挪动解压位置 - 若需兼容 PHP 5.3–5.5 等极老环境，可用
classmap替代，但必须手动运行composer dump-autoload -o生效
别试图在 Composer 2.x 中“恢复”target-dir 行为——它不存在于代码中，不是配置开关能打开的。
容易被忽略的关键点
最隐蔽的问题是：某些私有仓库镜像或老旧 CI 脚本会缓存 1.x 时代的 composer.lock，其中记录了基于 target-dir 解压的路径。当在新环境用 Composer 2.x 执行 composer install 时，lock 文件里的路径信息仍会被读取，但实际安装行为已变，导致 vendor/autoload.php 加载失败或类文件物理位置错乱。遇到这类问题，第一反应不是修配置，而是删掉 composer.lock 和 vendor/，再重新生成。
