Composer默认共享缓存，所有项目复用~/.composer/cache/files和repo目录中的zip包与元数据，无需手动配置；但需确保未清缓存、PHP/Composer版本一致，且避免权限、路径空格及VCS缓存未同步等问题。
多项目共用缓存靠的是默认行为，不是手动配置
Composer 默认就让所有项目共享同一个缓存目录，只要没清过 ~/.composer/cache（Linux/macOS）或 %APPDATA%\Composer\cache（Windows），重复执行 composer install 就会跳过下载——它复用的是 cache/files/ 里的 zip 包和 cache/repo/ 里的元数据，不是 vendor 目录本身。
你不需要为每个项目单独配路径，也不用写脚本搬运缓存。只要确保：
-
composer install --prefer-dist是默认行为（新版 Composer 已默认启用） - 没执行过
composer clear-cache或手动删过cache/目录 - 所有项目用的 PHP 版本、Composer 版本、平台配置（如
platform.php）尽量一致；否则缓存里存的 dist 包可能不兼容，导致安装失败
为什么改了 cache-dir 还是不生效？
因为 COMPOSER_CACHE_DIR 环境变量优先级高于 composer config --global cache-dir。如果你在 CI 或 Docker 里设了环境变量，或者 shell 配置里 export 过该变量，composer config --global cache-dir 的值就完全被忽略。
验证真实路径的唯一可靠方式是运行：
composer global show -v | grep "Cache directory"
而不是看 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 不解析
~，也不能处理带空格的路径，建议用符号链接绕过 - 权限不对：比如
sudo composer global require把~/.composer/cache归属变成root:root，普通用户后续所有命令都会卡在Permission denied - 挂载卷问题：Docker 或 NFS 挂载的路径可能静默拒绝写入，错误只出现在
composer -vvv日志里
cache-vcs-dir 必须单独配，否则 Git 包白缓存
Composer 的 VCS 缓存（即 Git clone 后的裸仓库）和主缓存目录完全独立。即使你设了 cache-dir，若没显式配置 cache-vcs-dir，每次遇到 git@ 或 HTTPS Git 地址的包，Composer 都会重新 clone，根本不走缓存。
正确做法是同步设置：
composer config --global cache-vcs-dir "$HOME/.composer-cache/vcs"
注意：这个路径必须和 cache-dir 在同一层级逻辑下管理，且需保证可写。如果用了 COMPOSER_CACHE_DIR，也要确保 cache-vcs-dir 指向其子目录，否则两个缓存路径割裂，VCS 部分依然无效。
K8s 和 CI 里别碰 HostPath 共享缓存
在 Kubernetes 或 GitHub Actions/GitLab CI 中，试图通过挂载 HostPath 或共享 volume 让多个 Pod/Job 复用 ~/.composer/cache 是确定性失败。原因包括：
- Pod 以非 root 用户运行，但
/root/.composer/cache或/home/www-data/.composer/cache根本不存在 - tmpfs 默认 inode 数量极少，解压 ZIP + 写 JSON 快速耗尽，报
No space left on device - 多个进程同时争抢
cache.lock，导致composer install卡死或静默失败 - 节点调度不固定，HostPath 挂载点在不同节点上内容不一致
真正有效的方案是构建期固化：Dockerfile 里用多阶段构建把 vendor/ 打进镜像，或在 CI 脚本中按 PHP 版本 + Composer 版本组合隔离缓存路径，例如 $HOME/.composer-cache-php8.2-composer2。
最易被忽略的一点：CI 平台（尤其是 GitLab）即使声明了 cache: 路径，若没显式设置 COMPOSER_CACHE_DIR 环境变量，Composer 仍会写入默认位置，缓存完全不命中。
