正确方式是用composer config --global cache-dir设置绝对路径并确保目录存在、权限正确，而非手改json；环境变量composer_cache_dir优先级更高，验证须用composer diag | grep "cache directory"。
用 composer config --global cache-dir 写入，别手改 JSON 文件
手动编辑 ~/.composer/config.json 或 %APPDATA%\Composer\config.json 极易出错：多一个逗号、用中文引号、结尾少斜杠，Composer 就会静默跳过整个文件，后续所有命令都走默认缓存路径，且不报错、不提示。而 composer config --global cache-dir 会自动校验 JSON 格式、处理路径转义、写入正确位置，并触发内部缓存刷新。
必须显式加 --global（或 -g），否则会误写进当前项目的 composer.json；值必须是绝对路径，相对路径如 ./cache 或 ~/cache 会被忽略。
- Linux/macOS 示例：
composer config --global cache-dir /data/composer-cache - Windows（CMD/PowerShell）示例：
composer config --global cache-dir "C:\Users\YourName\AppData\Local\Composer\Cache"（含空格或反斜杠时必须用英文双引号包裹）
路径必须存在、有读写权限，否则 Composer 会卡住或报 Permission denied
Composer 不会自动创建缓存目录。执行完 config 命令后，得立刻手动创建并赋权：
- Linux/macOS/WSL：
mkdir -p /data/composer-cache && chmod 755 /data/composer-cache - Windows：在资源管理器中新建目录，右键 → “属性” → “安全” → 确保当前用户有“完全控制”权限
- CI/Docker 中尤其注意：如果用
root用户运行 composer，目录属主也必须是root，否则会出现file_put_contents(...): failed to open stream类错误，但 Composer 往往只是悄悄 fallback 到默认路径
验证方式不是看命令是否返回 OK，而是运行 ls -ld $(composer config --global cache-dir)（Linux/macOS）或检查该目录属性（Windows），确认归属和权限匹配当前运行用户。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证是否真生效，只信 composer diag 和日志
composer config --global cache-dir 输出的只是配置项内容，不代表实际生效路径。真正起作用的是运行时解析结果，它受三重优先级影响：COMPOSER_CACHE_DIR 环境变量 > 全局 config 配置 > 默认路径。所以：
- 先运行
composer diag | grep "Cache directory"，输出的才是 Composer 实际使用的路径 - 再运行
composer clear-cache -vvv，观察日志里清理的是不是你设的新路径 - 执行一次
composer install -vvv，搜索日志中的Writing into cache行，确认路径匹配 - 如果
composer diag显示的仍是默认路径（如C:\Users\xxx\AppData\Roaming\Composer\Cache），优先检查是否设置了COMPOSER_CACHE_DIR环境变量（比如 CI 脚本或 Dockerfile 中），它会覆盖 config 配置
CI/CD 和 Docker 中缓存失效的常见盲点
即使路径配对了，缓存也可能从不命中。关键在于 Composer 缓存复用依赖三个条件严格一致：
- PHP 版本（小版本不同即视为不一致）
-
composer.lock文件内容完全相同（建议用hashFiles('**/composer.lock')生成 key） - 镜像源 URL 完全一致（本地用阿里云镜像，CI 却走 packagist.org，缓存文件虽存在，但 Composer 会拒绝使用）
Docker 构建时，COPY composer.json composer.lock ./ 必须放在 COPY . . 之前；GitHub Actions 使用 actions/cache@v4 时，key 必须包含 lock 文件哈希；GitLab CI 必须显式设置 COMPOSER_CACHE_DIR 变量，不能只靠 cache: 声明路径——否则 Composer 仍写入默认位置。
最容易被忽略的是：缓存路径和镜像源必须成对锁定。改了镜像却没清旧缓存，或换了 PHP 小版本但没更新缓存 key，都会让缓存变成“幽灵目录”——看着在，实则从不命中。
