COMPOSER_HOME环境变量直接决定全局配置目录位置，Composer启动时优先读取该变量值作为唯一权威路径，设则使用、不设则回退默认路径；Linux/macOS需写入~/.zshrc等初始化文件并source或新开终端生效，Windows需用setx或[Environment]::SetEnvironmentVariable设置并重启终端，且必须手动迁移auth.json、config.json及重装全局包，否则静默失败。
COMPOSER_HOME 环境变量直接决定全局配置目录位置
Composer 启动时第一件事就是检查 COMPOSER_HOME 环境变量；设了就用它，没设才 fallback 到默认路径（~/.composer 或 %APPDATA%\Roaming\Composer）。它不是“可选配置”，而是唯一权威路径来源——改它，auth.json、config.json、全局插件、缓存、vendor/bin/ 下的全局二进制文件全跟着走。
Linux/macOS 下永久设置 COMPOSER_HOME 的实操要点
必须写进 shell 初始化文件（如 ~/.zshrc 或 ~/.bashrc），而不是临时执行 export。否则新终端或 CI job 里变量就丢了。
- 执行
echo 'export COMPOSER_HOME="/path/to/my/composer"' >> ~/.zshrc - 运行
source ~/.zshrc生效（或新开终端） - 验证：运行
composer config --global home，输出应是你设的路径 - 旧数据需手动迁移：
cp -r ~/.composer/* $COMPOSER_HOME/，再清空原目录（尤其注意auth.json权限）
Windows 上设置 COMPOSER_HOME 的常见陷阱
PowerShell 和 CMD 处理路径的方式不同，且系统级和用户级环境变量加载时机不一致，容易漏生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- CMD：用
setx COMPOSER_HOME "D:\my-composer"（注意双引号，且需重启 cmd） - PowerShell：用
[Environment]::SetEnvironmentVariable("COMPOSER_HOME", "D:\my-composer", "User")，然后重启终端 - 别用相对路径（如
.\composer）——Windows 下解析不可靠 - 路径含空格没问题，但 IDE 或 CI 脚本里调用 composer 时，确保其启动环境也加载了该变量（比如 GitHub Actions 需显式用
env:块注入）
为什么改了 COMPOSER_HOME 还报错找不到 auth.json？
因为 Composer 不会自动把旧配置复制过去，也不检查目标目录是否存在。它只按变量值硬读 $COMPOSER_HOME/auth.json，如果该文件不存在或权限不对，就会静默失败或提示认证错误。
-
mkdir -p $COMPOSER_HOME先建目录（Windows 对应mkdir D:\my-composer） - 把原
~/.composer/auth.json拷过去，并确保权限为 600（Linux/macOS）或无继承权限（Windows） - 全局安装的包（如
phpunit）不会自动重装，得手动跑一次composer global install - CI/CD 中多个 job 共享机器时，若共用同一
COMPOSER_HOME，凭据和缓存会互相污染——必须每个 job 用独立路径，比如COMPOSER_HOME=/tmp/composer-$RUN_ID
实际路径切换后，composer global list 和 composer diagnose 会立刻反映新位置，但所有依赖该路径的脚本、IDE 设置、CI 配置都得同步更新——这点最容易被跳过。
