国内用 composer 必须配置镜像，否则依赖安装大概率失败；常见配置错误包括参数名拼写错误、缺少 type 参数、url 缺少末尾斜杠；需验证配置是否生效，并注意全局配置在宝塔、ci 等环境下的用户权限问题；镜像不加速依赖解析阶段，卡在 resolving 需检查约束条件与私有源；生产环境推荐使用 --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative 组合提速。
composer config -g repo.packagist 命令为什么总不生效
这条命令极易静默失败，且不报错。90% 的“换源后还是慢”问题，都卡在这三处细节上：
-
repo.packagist不能写成repos.packagist（多一个 s 就彻底无效，Composer 完全忽略） - 中间必须显式传
composer作为 type 参数：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉composer就 fallback 到默认源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/p2//类路径，直接 404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明没写进去。
宝塔、CI 或 Docker 环境里镜像不生效
全局配置写在 ~/.composer/config.json，但它只对当前用户生效。而宝塔「PHP 管理器」、计划任务、GitHub Actions 默认以 www 或 runner 用户运行，根本读不到 root 下的配置。
- 查实际执行用户：
whoami或看 CI 日志里的 UID - 针对性配置：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥的做法是项目级配置：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动追加到composer.json的repositories字段，不覆盖已有私有源
换镜像后还是卡在 Resolving dependencies
镜像只加速下载环节（Downloading），不参与依赖解析（Resolving dependencies）。这个阶段完全离线，卡住说明本地约束有问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束会让求解器暴力尝试所有组合 -
"minimum-stability": "dev"强制拉取不稳定分支，候选版本数爆炸 -
composer.lock被删或未提交，install实际退化为update - 项目
composer.json中repositories指向了已下线私有源，Composer 逐个超时才 fallback
快速排查：composer config --list | grep repositories 看实际生效的是哪个源；再跑 composer validate --strict 确认 lock 文件合法。
真正提速的参数组合（尤其 CI/CD）
光换镜像只是第一步。生产环境必须加这四个参数：
-
--no-dev：跳过require-dev（如 phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免 git clone 的 I/O 和网络开销（注意：若项目写了"prefer-source": true，该参数会被静默覆盖） -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉自动加载器“没在映射里 = 真没有”，彻底跳过文件扫描
CI/CD 中推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类会直接 Class not found。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
