composer config --global cache-dir是唯一推荐方式，因它自动校验JSON格式、处理路径转义、写入正确位置并刷新缓存；手动改配置文件易因语法错误导致静默失效。
必须用 composer config --global cache-dir 命令写入，手动改 JSON 文件大概率静默失效——Composer 遇到任何 JSON 解析错误（比如多一个逗号、中文引号、BOM 头）就直接跳过整个配置文件，不报错也不 fallback，你改的它根本没读。
为什么 composer config --global cache-dir 是唯一推荐方式
这条命令会自动校验 JSON 格式、处理路径转义、写入正确位置（Linux/macOS 是 ~/.composer/config.json，Windows 是 %APPDATA%\Composer\config.json），并触发内部缓存刷新。关键点：
- 必须显式加
--global（或-g），否则会误写进当前项目的composer.json - 值必须是绝对路径：
/data/composer-cache✅，~/cache❌，./cache❌ - 路径需提前创建，且当前用户有读写权限（
ls -ld第三列应为你的用户名） - Windows 下含空格或反斜杠时，必须用英文双引号包裹：
composer config --global cache-dir "D:\my composer\cache"
怎么确认新路径真的生效了
composer config --global cache-dir 输出只是配置值，不代表运行时实际使用路径。真正验证方式只有两个：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer diag | grep "Cache directory"，输出的路径必须与你设置的一致 - 执行
composer clear-cache后，观察日志里清理的是不是你设的新路径；再跑一次composer install -vvv，搜Writing into cache行，路径要匹配 - 如果
composer diag仍显示默认路径（如~/.composer/cache或%APPDATA%\Composer\Cache），优先检查环境变量COMPOSER_CACHE_DIR是否被设了——它优先级最高，会覆盖所有配置
临时换路径或 CI 场景下怎么绕过全局配置
不想永久改配置？比如在 GitHub Actions 或 Docker 构建中单次使用 D 盘缓存，直接设环境变量最干净：
- Bash：
export COMPOSER_CACHE_DIR="/d/ci-cache" && composer install - PowerShell：
$env:COMPOSER_CACHE_DIR="D:\ci-cache"; composer install - 该变量必须是绝对路径，进程退出即失效，且优先级高于
cache-dir配置 - Dockerfile 中要用
ENV COMPOSER_CACHE_DIR="/tmp/composer-cache"，不能用RUN export（只在当前层生效）
旧缓存不会自动迁移，但容易被忽略的其实是子目录结构
Composer 缓存目录下必须包含 files/、repo/、vcs/ 这些子目录才能正常工作。如果你只配了 cache-dir，但没手动创建或没让 Composer 初始化这些子目录，它会静默 fallback 到默认路径。
更隐蔽的问题是：有些场景下你得额外配 cache-files-dir（比如指向 /path/to/cache/files），否则即使 cache-dir 生效了，files/ 子目录也可能为空——验证时别只看父目录是否存在，要进 files/ 里确认有没有哈希命名的 zip 包生成。
