根本原因是多用户共用 ~/.composer/cache 目录且 Composer 默认不隔离，导致权限冲突和缓存污染；解决方案是用 COMPOSER_CACHE_DIR 环境变量强制隔离每个用户的缓存路径，并同步配置 cache-vcs-dir 与正确权限。
为什么多用户机器上 Composer 全局缓存会互相污染
根本问题不是“缓存太大”，而是 ~/.composer/cache（或 ~/.config/composer/cache）目录被多个用户共用，且 Composer 默认不隔离。一旦某人用 sudo composer global require，整个 cache/ 目录归属变成 root:root，其他用户执行任何 composer 命令都会卡在 Permission denied —— 连 clear-cache 都进不去。
更隐蔽的是：不同用户安装的同一包（如 phpunit/phpunit）可能因平台配置、PHP 版本差异，导致缓存里存了互不兼容的元数据；而 Composer 不校验用户上下文，直接复用，结果就是 A 用户装得好好的项目，在 B 用户机器上 composer install 突然报 “Could not find package” 或解析出错版本。
-
composer config --global cache-dir输出不可信，它只显示配置值，不反映实际路径；真实路径得看composer global show -v里的Cache directory:行 - 即使设了独立路径，若该路径挂载在 NFS 或 Docker volume 上，内核可能静默拒绝写入，错误只藏在
-vvv日志里 -
cache-vcs-dir必须单独配，否则 Git 包每次重 clone，和cache-dir完全无关
最稳方案：用环境变量强制隔离每个用户的缓存
别碰 composer config --global cache-dir，它优先级低、易被覆盖、且多用户下写一次就全局生效。直接用 COMPOSER_CACHE_DIR 环境变量，它是 Composer 启动时最高优先级的缓存路径控制项。
- Linux/macOS：在
~/.zshrc（或~/.bashrc）里加一行export COMPOSER_CACHE_DIR="/home/$USER/.composer-cache"，然后source ~/.zshrc - Windows PowerShell：在用户配置文件里加
$env:COMPOSER_CACHE_DIR="$HOME\composer-cache" - Docker 中必须显式注入：
docker run -e COMPOSER_CACHE_DIR=/cache -v $(pwd)/cache-$(whoami):/cache ... - 路径里不能含空格或英文双引号；若必须带空格，用符号链接绕过，比如
ln -s "/mnt/big disk/composer-cache" ~/composer-cache
配完后，每个用户启动的 Composer 进程都只读写自己目录，互不干扰。验证方式：切换用户，运行 composer global show -v | grep "Cache directory"，确认路径指向各自家目录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须同步配的 cache-vcs-dir 和权限硬要求
cache-vcs-dir 是独立于 cache-dir 的另一套路径，专管 Git/SVN 克隆副本。不配它，composer require "git@github.com:xxx/yyy" 这类 VCS 依赖每次都会重 clone，浪费时间且加剧磁盘竞争。
- 运行
composer config --global cache-vcs-dir "/home/$USER/.composer-vcs-cache"（Linux/macOS） - 确保该路径存在、当前用户有
rwx权限——缺x权限会导致无法进入目录，报错静默失败 - 不要把缓存目录挂到 NFS、受限 Docker volume 或加密盘上；Composer 写缓存时依赖原子 rename 和 mmap，这些存储常静默不支持
- 清缓存前先查归属：
ls -ld $(composer config --global cache-dir)，如果不是当前用户，必须sudo chown -R $USER:$USER修复，否则clear-cache直接失败
CI/CD 和脚本中如何避免踩坑
CI 环境里最容易出问题是挂载了共享 COMPOSER_HOME，导致 A 项目缓存污染 B 项目 autoload 文件，最终 Class not found。这不是概率问题，是已复现的确定性故障。
- CI 脚本里永远显式指定用户：
su -c "composer install" -s /bin/sh runner，而不是默认用 root - 禁止在 CI 中使用
--global参数；所有命令必须在项目根目录下执行，且COMPOSER_HOME设为项目级临时路径，如COMPOSER_HOME=$(pwd)/.composer - 部署脚本里，若需全局工具（如
laravel/installer），改用composer config -g bin-dir ~/bin，再确保~/bin在 PATH 最前，且属主正确 - 验证是否生效：跑一次
composer install后，立刻检查$(composer config --global cache-dir)/repo/下是否有新增文件；没有则说明路径没生效或权限不对
真正容易被忽略的不是“怎么设”，而是“设完是否真在用”——多用户环境下，哪怕路径对了，只要权限或挂载方式不对，缓存就形同虚设，所有优化都白干。
