配不成功是命令错误而非网络问题，关键三点：键名必须为repo.packagist（非repos.packagist），type值必填composer，URL须HTTPS且末尾带/。
配不成功不是网络问题，是命令写错三个关键点：键名必须是 repo.packagist（不能多 s），composer 是必填 type 值（不能省），URL 必须 HTTPS 且末尾带 /——漏一个就静默回退官方源，不报错也不提示。
为什么 composer config -g repo.packagist 没生效
这条命令失败时几乎从不报错，但行为已退回 https://packagist.org。验证方式只有一种：composer config -g repo.packagist 输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
- 返回空、
null、或只输出 URL 字符串（新版 Composer 行为），说明没写进去 -
repos.packagist（多了一个 s）→ 键名错误，配置被忽略 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺少composertype 值，Composer 2.0+ 直接 fallback - URL 写成
http://或https://mirrors.aliyun.com/composer（缺末尾/）→ 请求路径拼错，返回 404 或元数据解析失败
composer.json 里怎么安全加镜像源
全局配置在 CI、宝塔、Docker 等场景下常失效，项目级配置才是团队协作和可复现构建的底线。用命令写入，别手改 JSON。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 该命令自动处理已有
repositories结构：若原为对象{}，转成标准格式；若原为数组[]，追加新项，不覆盖私有源 - 严禁手动写
"packagist.org": false—— 这会禁用所有基础包（如php、ext-json），导致composer install直接失败 - 改完必须删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件仍指向海外源
换源后还卡在 “Resolving dependencies”？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不参与依赖解析。卡在这里，99% 是 composer.json 写法或本地环境问题。
-
"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束会让 Composer 尝试数百种版本组合 -
"monolog/monolog": "dev-main"这类未锁定的 dev 分支，每次都要重新解析整个分支历史 - 项目含
fxp/composer-asset-plugin（常见于老 Yii2 项目）→ 它绕过 Composer 镜像机制，直连已不可用的 Bower/NPM 源 - PHP 版本太低（如 PHP 7.2）或太高（如 PHP 8.5.5 的某些扩展兼容性未同步）也会拖慢解析
CI 和宝塔环境下镜像为啥不生效
全局配置写在 ~/.composer/config.json，但执行用户 ≠ 配置用户。宝塔默认用 www 用户跑 PHP，GitHub Actions 用 runner 用户，它们根本读不到你本地 root 或 admin 的配置。
- 查真实执行用户：
whoami或看日志 UID - 给
www用户单独配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions 中显式设置：
COMPOSER_HOME: /github/home/.composer，再运行 config 命令 - 更稳妥的做法：CI 脚本开头就执行项目级配置命令，不依赖全局状态
最易被忽略的是：换源后首次 composer install 报 hash 校验失败，不是镜像问题，是旧 composer.lock 记录了海外源签名。删 lock 和 vendor 是硬性步骤，跳过等于白配。
