composer全局缓存目录必须用绝对路径配置，手动创建并设正确权限，通过composer diag验证生效，环境变量composer_cache_dir优先级最高，旧缓存需手动迁移。
composer config --global cache-dir 必须用绝对路径
Composer 不解析 ~、$HOME 或环境变量，写了就等于没配。比如 composer config --global cache-dir ~/composer-cache 看似合理，实际会被忽略，后续所有命令仍走默认路径。
正确写法是显式写出完整路径：
- Linux/macOS/WSL：
composer config --global cache-dir /data/composer-cache - Windows CMD：
composer config --global cache-dir "D:\composer-cache"（含空格或反斜杠必须加英文双引号） - PowerShell 中若用
%APPDATA%，需先展开成真实路径，否则可能写入错误位置
这条命令会自动校验 JSON 格式、写入正确配置文件（如 %APPDATA%\Composer\config.json 或 ~/.config/composer/config.json），比手改 JSON 安全得多。
目录必须手动创建且权限正确
Composer 从不自动建目录，也不会提示“目录不存在”。如果路径没创建或权限不对，它会静默 fallback 到默认缓存位置，导致你改了却完全没效果。
操作步骤要严格按顺序：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer config --global cache-dir写入路径 - 再手动创建目录：
mkdir -p /data/composer-cache（Linux/macOS）或资源管理器新建D:\composer-cache（Windows） - 设权限：Linux/macOS 运行
chmod 755 /data/composer-cache；Windows 检查该目录“属性 → 安全 → 当前用户有完全控制” - CI/Docker 中尤其注意：如果用
root执行composer config，但实际运行的是www-data用户，就得给目录设对属主：sudo chown -R www-data:www-data /data/composer-cache
验证是否真生效，别信 config 输出
composer config --global cache-dir 只显示你“写了什么”，不代表 Composer “用了什么”。真正生效路径得看 composer diag 的输出 —— 它会明确列出 Cache directory: 后面的路径。
更可靠的验证方式：
- 运行
composer clear-cache，观察日志里清理的是不是你设的新路径 - 执行
composer install -vvv，搜日志中Writing into cache行，确认路径匹配 - 检查环境变量是否覆盖：
echo $COMPOSER_CACHE_DIR（Linux/macOS）或echo %COMPOSER_CACHE_DIR%（Windows），若有值，它优先级最高，会直接绕过cache-dir配置
缓存内容不会自动迁移，旧包得手动处理
改完路径后，Composer 不会把老缓存搬过去。新项目会用新路径，但旧项目仍可能读老缓存（取决于是否命中、是否被清理）。
要不要迁移旧缓存？看场景：
- 想立刻释放 C 盘空间：直接删掉默认路径（如
%APPDATA%\Composer\Cache或~/.composer/cache） - 想保留已有包加快首次安装：用
rsync -a ~/.composer/cache/ /data/composer-cache/（Linux/macOS）或 Windows 资源管理器复制粘贴（注意保持子目录结构） - CI/CD 中建议清空重来，避免因 PHP 版本、镜像源或
composer.lock差异导致缓存污染
最容易被忽略的一点：缓存是否命中，不只看路径对不对，还取决于 composer.lock 哈希、PHP 版本、镜像源 URL 三者是否和缓存生成时一致。路径改对了，但镜像从 packagist.org 换成阿里云，旧缓存也基本不会被复用。
