能安全迁移，但必须分两步：先改配置再搬数据，跳过“剪切粘贴”；先用 composer config --global cache-dir 确认实际缓存路径及权限，再用该命令设新绝对路径并手动复制 files/ 和 repo/ 子目录。
能安全迁移，但必须分两步：先改配置再搬数据，跳过任何“剪切粘贴”操作。
确认当前缓存路径和权限
直接运行 composer config --global cache-dir 输出的路径才是 Composer 实际使用的缓存位置。别信默认值——它可能被 COMPOSER_CACHE_DIR 环境变量覆盖，也可能在 CI 环境中指向 NFS 挂载点。
Linux/macOS 下检查权限：ls -ld $(composer config --global cache-dir)；Windows 下右键该路径 → “属性” → “安全”标签页，确认当前用户有“完全控制”或至少“修改”权限。
如果输出为空或报错 Cache directory does not exist，说明配置异常，先执行 composer config --global cache-dir /tmp/composer-cache 临时设一个可写路径再继续。
用 config 命令改路径，别手动改 config.json
Composer 的全局配置由 composer config --global 管理，所有变更都会自动写入 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json）。手动编辑 JSON 容易格式出错，导致后续命令全部失败。
执行以下命令即可生效（以迁移到 /data/composer-cache 为例）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
mkdir -p /data/composer-cache composer config --global cache-dir /data/composer-cache
注意：/data/composer-cache 必须是绝对路径，不能含 ~；目录需提前创建且确保有读写权限；改完后立即生效，无需重启终端。
旧缓存不自动迁移，得手动复制+验证
composer clear-cache 不会帮你搬数据，新路径下缓存是空的，首次 install 会变慢，但不会出错。如果你希望保留历史包加速后续安装，需手动复制旧缓存内容：
- 只复制
files/和repo/子目录（它们是纯数据，无状态） - 跳过
vcs/—— 它包含 Git 裸仓库，路径硬编码且极易因权限或文件锁复制失败 - 复制后运行
ls -la /data/composer-cache/files | head -n 3确认文件存在且属主正确
复制命令示例（Linux/macOS）：
cp -r ~/.composer/cache/{files,repo} /data/composer-cache/
chown -R $USER:$USER /data/composer-cache
CI 或多用户环境要额外防坑
在 GitHub Actions、GitLab CI 或共享服务器上，缓存路径若指向 /tmp 或 NFS，可能引发权限冲突或 inode 耗尽。此时建议：
- 用
composer config --global cache-max-size "1G"限制体积，避免撑爆小分区 - 禁用 VCS 缓存：
composer config --global cache.vcs false，强制所有 Git 包走--prefer-dist - 确认
COMPOSER_HOME和COMPOSER_CACHE_DIR环境变量未与config --global冲突，可用composer config --global --list | grep cache检查
迁移完成后，composer clear-cache 清的是新路径，旧路径残留数据得手动删——别等它自动消失。
