正确做法是避免sudo导致配置写入root用户目录，应以目标用户身份执行composer config -g，同时检查目录权限、使用有效镜像源（如阿里云或腾讯云），并验证实际网络请求是否命中镜像域名。
composer config -g repo.packagist 命令必须用当前用户执行
很多人写自动化脚本时直接 sudo composer config -g repo.packagist https://mirrors.aliyun.com/composer/，结果发现配置没生效。这是因为 -g（global）参数写入的是当前用户的 ~/.composer/config.json，而 sudo 切换到了 root 用户上下文，实际改的是 /root/.composer/config.json，普通用户运行 composer install 时根本读不到这个配置。
正确做法是：在脚本里显式指定目标用户，或确保以目标用户身份运行整段命令：
- 若脚本由 deploy 用户执行，就别加
sudo，直接运行composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 若必须用 root 身份调度，改用
sudo -u deploy composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 检查是否生效：
composer config -g repo.packagist输出应为https://mirrors.aliyun.com/composer/，且该用户家目录下~/.composer/config.json中"repositories"字段已更新
国内源地址别用已停服的 packagist.phpcomposer.com
截至 2026 年，https://packagist.phpcomposer.com 已停止服务，脚本中硬编码该地址会导致后续所有 composer install 报 Could not fetch https://packagist.phpcomposer.com/packages.json 或超时失败。
目前稳定可用的国内镜像源只有两个官方推荐选项：
- 阿里云：
https://mirrors.aliyun.com/composer/（推荐，CDN 覆盖广、响应快） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（备选，部分地区延迟更低） - 注意：不要用
https://packagist.laravel-china.org等非官方维护源，它们已多年未同步，包索引严重滞后
脚本里要检测 ~/.composer 目录权限和归属
自动脚本跑完 composer config -g 后，如果目标用户首次使用 Composer，会自动生成 ~/.composer 目录。但若该用户之前由 root 创建过此目录（比如手动运行过 sudo composer），就会出现权限错：普通用户无法写入 ~/.composer/cache，导致 composer update 卡在 “Loading repository data…” 或报 Failed to write cache file。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
脚本中应包含修复逻辑：
- 确认目录存在：
mkdir -p /home/deploy/.composer（把deploy替换为实际用户名） - 修正归属：
chown -R deploy:deploy /home/deploy/.composer - 设最小必要权限：
chmod 700 /home/deploy/.composer（Composer 不需要 group/o 可读） - 特别注意：不能用
chmod -R 777—— 这会让 Composer 拒绝写入敏感文件（如 auth.json），并报Permissions check failed
验证镜像源是否真正生效的简单方式
光看 composer config -g repo.packagist 输出不保险。网络请求可能仍走默认源，尤其当项目根目录存在 composer.json 且含 "repositories" 字段时，全局配置会被覆盖。
脚本末尾建议加一行真实验证：
- 运行
composer show -p | head -n 5，观察输出中的 URL 是否含mirrors.aliyun.com - 或更直接：
strace -e trace=connect,sendto composer show monolog/monolog 2>&1 | grep -o 'mirrors\.aliyun\.com'，能捕获实际 HTTP 请求的目标域名 - 若返回空，说明镜像未生效——常见原因是用户家目录下有
.composer/auth.json且含旧源配置，需先清理或更新
镜像配置本身很简单，但生效依赖用户上下文、目录权限、项目级覆盖三者同时对齐；漏掉任意一环，自动化脚本就只是“看起来成功”。
