Composer没有“设home目录”的配置命令，唯一有效方式是设置COMPOSER_HOME环境变量；composer config --global home无效，因home不是支持的全局配置项，执行后既不生效也不报错，仅静默存入config.json且Composer完全不读取。
Composer 没有“设 home 目录”的配置命令，唯一有效方式是设置 COMPOSER_HOME 环境变量——composer config --global home 是无效操作，它不会改变任何实际路径。
为什么 composer config --global home 不起作用
这个命令看似合理，但 home 不是 Composer 支持的全局配置项。执行 composer config --global home /new/path 后：
• composer config --global --list 里根本不会出现 home 这一项
• composer global list 仍读取旧 vendor/ 目录
• auth.json 和 config.json 也不会被写入新路径
它只是安静地把键值存进 ~/.composer/config.json 的某个字段，Composer 自身完全不读取该字段。
正确设置 COMPOSER_HOME 的实操要点
环境变量才是 Composer 唯一认的“home 控制开关”，所有行为（全局配置、缓存、认证、全局包安装）都基于它：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS：在
~/.zshrc或~/.bashrc中添加export COMPOSER_HOME="/path/to/my-composer"，然后source ~/.zshrc - Windows PowerShell：
[System.Environment]::SetEnvironmentVariable('COMPOSER_HOME', 'D:\my-composer', 'User') - 临时测试：
COMPOSER_HOME=/tmp/test-composer composer --version（仅本次生效） - 验证是否真生效：
composer config --global --list | grep "home:"输出的路径必须是你设的；composer global status显示的vendor路径也必须匹配
改完 COMPOSER_HOME 后必须手动处理的几件事
环境变量一改，Composer 就换地方干活，但旧数据不会自动搬过去，以下三类必须人工干预：
-
auth.json和config.json：从原~/.composer/复制到新$COMPOSER_HOME/，否则私库认证、镜像源全部失效 - 全局包（如
laravel/installer）：原$COMPOSER_HOME/vendor/下的内容不会迁移，必须重装：composer global require laravel/installer -
$PATH：系统要能找到新vendor/bin/下的命令，需手动加进 shell 配置，例如：export PATH="$COMPOSER_HOME/vendor/bin:$PATH"
容易被忽略的权限和兼容性问题
最常导致静默失败的不是配置错，而是权限或路径硬编码：
- 如果用
sudo mkdir创建新COMPOSER_HOME目录，普通用户可能无写权限，composer global require会卡住或报Permission denied，务必chown $USER:$USER /path/to/my-composer - 某些 CI 脚本或老旧 Dockerfile 里硬写了
~/.composer，改了COMPOSER_HOME后这些路径就断了，得同步更新 - 多用户共享同一
COMPOSER_HOME时，不能只设变量，必须配属组 +chmod g+rw，否则第二个用户首次运行就会因写入失败而中断
真正生效的关键不在“设没设”，而在“设完之后有没有让 Composer 的所有上下游环节（shell、PATH、脚本、IDE）都意识到这个新家在哪”。漏掉任意一环，都会表现为“配置好像改了，但 global 包还是找不到、认证还是失败、缓存还是打不到”。
