Composer多用户不能共享COMPOSER_HOME，因auth.json、config.json、vendor/bin软链接及cache均用户专属，共享会导致权限冲突、配置覆盖与缓存校验失败；应为每个用户独立设置COMPOSER_HOME并统一配置镜像源。
Composer 多用户共享全局路径不可行，必须为每个用户单独配置 COMPOSER_HOME；强行共享会导致权限冲突、缓存污染和命令失败。
为什么不能真正共享 COMPOSER_HOME
Composer 的 COMPOSER_HOME 目录（默认 ~/.composer）包含：
– 用户专属的 auth.json（含私有仓库 token）
– 每个用户的 config.json（如 repo 镜像、proxy 设置）
– vendor/bin 软链接指向各自安装的全局包
– cache/ 下的下载包哈希与用户环境强绑定（PHP 版本、扩展差异会引发校验失败）
多个用户共用同一目录时，composer global install 会因写入权限拒绝或覆盖他人配置，composer update 可能误删其他用户的 vendor bin 文件。
多用户环境下正确设置全局路径的方法
每个用户应独立设置 COMPOSER_HOME，但可通过以下方式降低维护成本：
- 在所有用户 shell 初始化文件（如
~/.bashrc或/etc/skel/.bashrc）中统一添加：export COMPOSER_HOME="$HOME/.composer"
- 若需统一镜像源，用
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（-g表示当前用户全局配置，不跨用户） - 避免使用
sudo composer global—— 这会让 root 写入/root/.composer，普通用户无法读取其vendor/bin - 全局命令调用时，确保
$COMPOSER_HOME/vendor/bin在每个用户的$PATH中，且顺序靠前
常见错误现象与排查
执行 composer global list 报错或看不到已安装包？检查：
-
echo $COMPOSER_HOME是否为空或指向不存在路径 -
ls -l $COMPOSER_HOME/vendor/bin/权限是否为当前用户可读可执行（非root:root） -
composer global show是否返回空 —— 若是，说明global install实际写入了默认路径（未生效COMPOSER_HOME） -
which laravel（或其他全局二进制）是否指向/root/.composer/vendor/bin/laravel—— 这是误用sudo的典型痕迹
最易被忽略的一点：COMPOSER_HOME 必须在 shell 启动时就加载，不能在交互式终端里临时 export 后再运行 composer global —— 否则某些子进程（如钩子脚本）可能读不到该变量。把它写死在 ~/.profile 或 /etc/profile.d/composer.sh 才真正可靠。
