Composer target-dir怎么用 指定安装目标目录方法【详解】

target-dir 已被 composer 2.0 完全移除，应改用 psr-4 或 classmap 实现自动加载；包的物理安装路径由 name 字段决定，不可修改，静态资源分发可通过 scripts 配置 post-install-cmd 处理。

target-dir 已被弃用，别再用了

target-dir 是 Composer 1.x 早期版本中用于将包内某个子目录映射为安装路径的配置项，写在 composer.json 的 autoload 或 autoload-dev 下。但它在 Composer 2.0 中已被**完全移除**，任何使用它的包在 Composer 2+ 环境下会触发警告甚至失败——不是不生效，而是直接报错：target-dir is not supported anymore。

现在主流方案是改用 autoload 的 psr-4 或 classmap，配合正确的命名空间和目录结构来实现“逻辑安装位置”的效果。

想把类文件装到 vendor/xxx/yyy 目录下？你其实不需要 target-dir

Composer 安装包时的物理路径（如 vendor/myorg/mylib）由包名（name 字段）决定，无法通过 target-dir 或其他配置修改。所谓“指定安装目标目录”，本质是误解——Composer 不支持把一个包解压到非 vendor/{vendor}/{name} 的位置。

如果你的真实需求是：

• 让自己的类从 src/Utils 被自动加载为 MyOrgUtils* —— 用 psr-4 即可
• 想把第三方包的某部分代码“软链接”或“复制”到项目特定目录（如 public/js）——那是构建流程的事，该用 scripts + post-install-cmd
• 想让包发布时只暴露 dist/ 下的编译后文件 —— 应在 .gitattributes 中 exclude src/，而非依赖 target-dir

替代 target-dir 的正确 autoload 写法（PSR-4）

假设你的包结构是：

myorg/mylib/ ├── composer.json └── src/     └── http/         └── Client.php

且你想让 MyOrgMyLibHttpClient 正确加载，composer.json 应这样写：

{   "autoload": {     "psr-4": {       "MyOrg\MyLib\": "src/"     }   } }

关键点：

• psr-4 的 value 是相对于包根目录的路径，不是相对于 vendor
• 命名空间末尾必须带双反斜杠 \，否则自动加载器无法匹配
• 不要写 "MyOrg\MyLib\Http\": "src/Http/" —— 这会导致 Client 类被解析为 MyOrgMyLibHttpHttpClient
• 运行 composer dump-autoload 生效，无需 target-dir

如果非要“把文件放到别的目录”，用 scripts 搞定

比如你发了一个包，希望用户安装后自动把 assets/ 下的 css/JS 复制到 public/vendor/mylib/，可以在 composer.json 中加：

{   "scripts": {     "post-install-cmd": [       "cp -r vendor/myorg/mylib/assets public/vendor/mylib"     ],     "post-update-cmd": [       "cp -r vendor/myorg/mylib/assets public/vendor/mylib"     ]   } }

注意：

• 这属于副作用操作，不适合核心逻辑，仅适用于静态资源分发
• windows 用户需用 robocopy 或跨平台工具如 symfony/Filesystem
• 路径硬编码风险高，更健壮的做法是写个 PHP 脚本，用 __DIR__ 动态定位源目录

真正需要控制安装路径的场景极少，多数时候是混淆了「自动加载路径」和「物理安装路径」。盯住 psr-4 映射和 vendor 目录不可变这两条线，就很难走偏。