COMPOSER_HOME环境变量是Composer确定全局主目录的唯一依据，设则必用、不设才退默认；它支配config.json、cache/、vendor/bin/等全部用户级路径，且不影响项目级配置。
直接设 COMPOSER_HOME 环境变量，就能改 Composer 的全局 home 目录 —— 其他方式要么无效，要么只影响局部，别绕弯。
怎么永久修改 COMPOSER_HOME（Linux/macOS）
改的是 shell 启动时加载的环境变量，不是 Composer 自己的配置文件。
- 编辑
~/.zshrc（Zsh 用户）或~/.bash_profile（Bash 用户） - 加一行：
export COMPOSER_HOME="$HOME/.my-composer"（路径可自定义） - 执行
source ~/.zshrc重载配置 - 验证：
echo $COMPOSER_HOME应输出新路径；composer config --global home也得一致
注意：改完后 composer global require 安装的二进制（如 laravel）会写进 $COMPOSER_HOME/vendor/bin/，但旧 PATH 里大概率还指向 ~/.composer/vendor/bin —— 得手动把新路径加进 PATH，否则命令找不到。
怎么临时用一个不同的 home 目录
适合 CI 脚本、隔离测试、或不想污染主配置的场景。
- 单次生效：
COMPOSER_HOME=/tmp/composer-test composer --version - 脚本内批量使用：在脚本开头统一设变量，后续所有
composer命令自动继承 - 不推荐用
--home参数：它只对当前命令的“配置读取”起作用，global require仍可能写错位置，行为不一致
临时路径下不会自动继承旧 auth.json 或 config.json，首次运行会生成空配置，需手动复制或重新配置认证（比如 GitHub token）。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
改了 COMPOSER_HOME 为什么 composer global list 没包？
因为全局包没迁移，只改路径不等于自动搬数据。
-
vendor/目录不会复制，也不会 symlink，必须重装：composer global require laravel/installer -
config.json和auth.json也得手动复制过去，否则认证失效、镜像源丢失 -
cache/可不清，清了也没坏处；但别复制旧缓存，不同 Composer 版本缓存格式可能不兼容 - 检查是否真在用新路径：
composer global status输出的 vendor 路径，就是$COMPOSER_HOME/vendor
最容易被忽略的是权限问题：如果新目录是 sudo mkdir 创建的，普通用户可能无写权限，composer global require 会静默失败或报 Permission denied。
多用户共享同一个 COMPOSER_HOME 怎么办
不能只改 COMPOSER_HOME，必须配组权限，否则第二个用户一运行就卡住。
- 创建共享目录并设属组：
sudo mkdir -p /opt/composer-global && sudo chgrp composers /opt/composer-global - 开启 setgid：
sudo chmod g+rws /opt/composer-global，确保新建文件继承组 - 所有用户加入
composers组，并各自 shell 配置中设export COMPOSER_HOME="/opt/composer-global" - PHP CLI 层可能拦截：
vendor/bin下的脚本若被open_basedir限制或disable_functions拦掉proc_open，会直接报错退出
真正难的不是路径指向哪，而是 vendor/ 里成百个文件的权限继承、PHP 运行时上下文、以及不同用户安装包时的 umask 差异 —— 一旦有人绕过组机制直接 chown，整个共享就不可用了。
