Composer没有data-dir配置项，它不被任何版本源码解析、不出现于config schema、不响应config命令；真正可配的路径只有cache-dir（缓存）、vendor-dir（依赖代码）和bin-dir（可执行脚本）。
Composer 没有 data-dir 这个配置项，它根本不会被识别、不会生效、也不在任何版本的源码中存在。 你看到的所谓“设置 data-dir”教程，基本是混淆了 cache-dir、vendor-dir 或误读了第三方插件行为。
为什么 data-dir 配置完全无效
Composer 的配置 schema 是硬编码校验的，所有已知版本（2.2–2.7）源码里都搜不到 data-dir 字段的解析逻辑。它既不出现在 composer config --list 输出中，也不会被 composer config -g data-dir 读取或写入——返回空不是“没设”，而是“压根没这个 key”。你在 composer.json 里写 "data-dir": "xxx"，或者运行 composer config data-dir xxx，Composer 都会安静忽略，不报错、不警告、不创建目录。
常见混淆来源包括：
- 把 Composer 全局目录
COMPOSER_HOME（如~/.composer）当成可配置项——它是硬编码路径，首次运行时自动创建，不能通过 config 改 - 看到别人脚本里用了
COMPOSER_DATA_DIR环境变量——这是用户自定义变量，Composer 自身完全不读取 - 和 Laravel 的
storage_path()或 Symfony 的kernel.project_dir类比，套错了框架逻辑
cache-dir：唯一真正影响“缓存数据”的路径
如果你实际想控制的是下载包、元数据、dist 解压临时文件的存放位置，该配的是 cache-dir，不是不存在的 data-dir。它独立于 vendor-dir，不参与运行时加载，只影响下载和安装效率。
生效方式优先级从高到低：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 环境变量
COMPOSER_CACHE_DIR（临时覆盖，CI/CD 最常用） - 全局配置：
composer config -g cache-dir /path/to/cache - 项目级配置（不推荐）：
"config": {"cache-dir": "cache"}写进项目composer.json，但会被全局和环境变量覆盖
注意：cache-dir 必须是绝对路径（环境变量方式可含 $HOME），且目标目录需有读写权限；改完后旧缓存不会自动迁移，建议手动清空原 ~/.composer/cache 并确认新路径已生成 repo/、files/ 等子目录。
vendor-dir：控制“安装后依赖代码”的位置
如果你真想调整的是 vendor/ 目录位置（即最终解压的包代码、autoload.php、bin/ 脚本所在处），那唯一有效字段是 vendor-dir，但它只接受相对路径，且必须写在项目根目录的 composer.json 中：
{
"config": {
"vendor-dir": "libs"
}
}
关键约束：
- 不能写在全局
~/.composer/config.json里——Composer 完全不读 - 改完必须删掉旧
vendor/，再运行composer install（不是update）才生效 - 值不能以
/开头，也不能含..，例如"vendor-dir": "../libs"会静默失败 - 改完后
vendor-dir和bin-dir必须协同设置，否则vendor/bin/下的软链接可能指向错误位置
真正难的不是配哪个字段，而是分清“谁管什么”
Composer 没有“统一数据根目录”概念。它的路径策略是功能切分的：cache-dir 管下载缓存，vendor-dir 管安装产物，bin-dir 只管软链接位置——三者无父子关系，也不能靠一个字段联动。漏掉任何一个同步点，比如只改 vendor-dir 却忘了调 bin-dir，后续跑 phpunit 或 laravel tinker 就可能找不到命令。更麻烦的是，这些路径一旦分散在不同层级（环境变量 + 全局 config + 项目 config），优先级容易互相覆盖，调试时得逐层用 composer config --list 和 composer show --working-dir 对照验证。
