Composer config -g repo.packagist 不生效根本原因是三个硬性条件未同时满足：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一缺失即静默回退官方源，返回空或 null 且无报错。
composer config -g repo.packagist 命令为什么总不生效
不是网络问题，是命令写错三个关键点导致静默失败——不报错、不提示、配置为空。
必须同时满足：repo.packagist（单数，不能写成 repos.packagist 或 packagist.org）、composer（这是 type 值，不是可选参数）、URL 必须是 HTTPS 且末尾带斜杠 /。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 正确 -
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/❌ 多个 s，完全无效 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 缺composertype，fallback 到官方源 -
composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/❌ HTTP 被 Composer 2.0+ 拒绝
验证是否写入成功：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null 或报 Key not found，说明没写进去。
项目级镜像配置比全局更可靠
全局配置在 CI/CD、宝塔面板、多用户环境里根本读不到——GitHub Actions 默认用 runner 用户，宝塔用 www 用户，它们的 ~/.composer/config.json 是空的。
进项目根目录后执行这条命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉 -g）。
- 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories"数组，该命令会追加而非覆盖，避免误删私有包源 - 切勿手动编辑时写成
"packagist.org": false，否则镜像会被直接屏蔽
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则旧 lock 文件仍指向海外源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后还卡在 Resolving dependencies 怎么办
镜像只加速下载，不解决依赖解析慢的问题。卡在这里和镜像源完全无关。
常见诱因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 尝试大量组合 -
require-dev里塞了太多工具包（比如phpunit/phpunit+friendsofphp/php-cs-fixer+larastan/larastan） - 用了未锁定的 dev 分支，例如
"monolog/monolog": "dev-main"
临时验证方法：把 composer.json 中 require-dev 整块注释掉，再跑 composer update --no-dev。如果秒出结果，就说明是 dev 包拖慢了解析。
宝塔面板下 Composer 镜像配置容易漏掉的关键步骤
很多人在宝塔里配完镜像还是报 could not find package，是因为 PHP CLI 环境本身就不健全。
必须依次检查并处理：
- 在宝塔「PHP 管理」→ 当前版本 → 「禁用函数」中，**手动删除**
putenv、proc_open、pcntl_signal - 执行软链接：例如 PHP 8.0 要运行
ln -sf /www/server/php/80/bin/php /usr/local/bin/php - 确认
php -m | grep openssl有输出，否则 TLS 握手失败，镜像 URL 直接 403 - 全局镜像命令执行后，再运行
composer clear-cache—— 宝塔默认缓存路径可能和本地不同，清缓存才能刷新元数据
最隐蔽的坑：宝塔终端默认以 root 用户运行，但网站实际由 www 用户启动；如果你只给 root 配了镜像，www 用户跑 composer install 时依然走官方源。
