Composer读不到COMPOSER_ROOT_VERSION等变量，主因是PHP进程未继承该环境变量，或被composer.json中同名config项覆盖；需用php -r "var_dump(getenv('...'))"验证PHP是否实际获取，而非仅shell中echo可见。
Composer 读不到 COMPOSER_ROOT_VERSION、COMPOSER_VENDOR_DIR 这类环境变量，不是因为你写错了，大概率是变量没被 PHP 进程实际继承，或者被更高优先级的配置覆盖了。
为什么 echo $COMPOSER_ROOT_VERSION 有值但 Composer 不生效
Shell 中能打印出变量 ≠ PHP 子进程能读到。Composer 是用 PHP 执行的，而 PHP CLI 默认不自动继承所有 shell 环境变量（尤其在某些 Windows 终端、WSL 或 CI 环境下）。
- 检查是否在启动 PHP 前就设定了变量：Linux/macOS 推荐用
export COMPOSER_ROOT_VERSION=dev-main，且确保在运行composer install的同一 shell 中执行 - Windows CMD 下要用
set COMPOSER_ROOT_VERSION=dev-main，PowerShell 则必须用$env:COMPOSER_ROOT_VERSION="dev-main"（CMD 的set对 PowerShell 无效） - 如果用 IDE（如 PhpStorm）或 GUI 终端启动，它们可能不加载你的
.bashrc或.zshrc，变量根本没设进去 - 验证方式：运行
php -r "print_r(getenv('COMPOSER_ROOT_VERSION'));"，输出为空就说明 PHP 没拿到
COMPOSER_* 变量被 composer.json 配置项覆盖
环境变量优先级虽高，但仅对「未显式声明」的配置项起作用；一旦 composer.json 的 config 块里写了同名字段，它就会直接屏蔽环境变量。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 比如
composer.json里有"config": { "vendor-dir": "lib" }，那COMPOSER_VENDOR_DIR就完全失效 -
COMPOSER_ROOT_VERSION也一样：如果composer.json里写了"version": "1.2.0"，这个值会优先生效，环境变量只在无version字段且 Git 无法推断时才兜底 - 临时绕过方法：加
--no-plugins参数可禁用部分插件干扰，但不能跳过 config 合并逻辑
CI/CD 中变量“看似设置成功”实则未透传
GitHub Actions、GitLab CI、Jenkins 等平台默认不把 secrets 或 env 变量透传给子 shell 的 PHP 进程，尤其当命令套了 sh -c 或通过脚本间接调用时。
- GitHub Actions 必须显式写成：
env: { COMPOSER_ROOT_VERSION: ${{ secrets.ROOT_VERSION }} }，不能只靠run: echo "COMPOSER_ROOT_VERSION=..." >> $GITHUB_ENV - GitLab CI 要用
variables:块定义，且确保 job 使用的是shellexecutor（notdocker），否则容器内又是一套环境 - 本地模拟 CI 行为：用
env -i COMPOSER_ROOT_VERSION=dev-main composer install测试——-i清空所有变量再注入，最接近 CI 的干净环境
Windows 下 set 和 setx 混用导致失效
很多人在 Windows 上用 setx 设了系统级变量，结果命令行里还是读不到，因为 setx 不影响当前会话，只对新启动的进程生效。
-
set COMPOSER_ROOT_VERSION=dev-main：仅当前 CMD 窗口有效，关掉就丢 -
setx COMPOSER_ROOT_VERSION dev-main：写入注册表，但需新开一个 CMD 才能生效 - PowerShell 中
$env:xxx是会话级，[Environment]::SetEnvironmentVariable()才是持久化，两者别混 - 验证建议：在设完变量后，**立刻新开一个 CMD / PowerShell 窗口**，再运行
php -r "var_dump(getenv('COMPOSER_ROOT_VERSION'));"
真正卡住人的地方往往不是变量名拼错，而是变量生命周期和作用域没对齐——PHP 进程看不到、配置文件盖掉了、CI 平台没透传、Windows 会话没刷新。动手前先用 php -r "print_r($_ENV);" 或 getenv() 直接看 PHP 看到了什么，比猜强得多。
