必须配置中文镜像源，正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；项目级配置更可靠，需删vendor和lock后重装；卡在“Resolving dependencies”则与镜像无关，应检查PHP版本约束、开发依赖或废弃插件。
小程序后端用 PHP 开发时，composer create-project 或 composer install 卡住、报 could not find package、vendor 目录为空——基本不是你代码或网络问题，而是没走对中文镜像源。国内直连 packagist.org 在 TLS 握手和 DNS 层已被阻断，必须配镜像，且配置稍有偏差就静默失效。
composer config -g repo.packagist 命令为什么总不生效
这条命令执行后没报错，但 composer config -g repo.packagist 输出为空或仍是 https://packagist.org，说明根本没写进去。常见原因有三个：
- 键名写错：必须是
repo.packagist（单数repo，不是repos或repository） -
composer是 type 值，不是可选参数——漏掉就会 fallback 到官方源 - URL 末尾少斜杠
/：比如写成https://mirrors.aliyun.com/composer，实际会拼出/packages.json导致 404
正确写法只有一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。执行前先确认全局配置路径可写：composer config -g --list，Windows 下常因权限不足写入失败。
项目级配置比全局更可靠，尤其适合小程序后端部署
小程序后端常跑在宝塔、Docker 或 CI 环境里，全局配置容易丢失——比如 GitHub Actions 用的是 runner 用户，宝塔默认以 www 用户运行，都读不到你本地的 ~/.composer/config.json。
进项目根目录，直接运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）。它会在 composer.json 顶层自动加字段："repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}。
注意：
- 如果已有
"repositories"数组，该命令会合并而非覆盖；手动编辑时 JSON 必须合法，尤其不能多逗号 - 改完建议删掉
vendor/和composer.lock，再跑composer install确保从新源拉取 - 小程序后端若用 Laravel/ThinkPHP 框架，其
composer.json里若有旧版"repositories"字段，得先注释掉再试
换源后仍卡在 “Resolving dependencies”？这跟镜像无关
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。卡在这里，99% 是 composer.json 写法或环境问题：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，让 Composer 尝试遍历大量不兼容版本 -
require-dev里塞了太多工具链（如phpunit、phpstan），大幅增加解空间 - 用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它绕过镜像机制直连 Bower/NPM 源
这类问题换任何镜像都无效。得收紧 php 版本约束（例如明确写 "php": "^8.2"）、把开发依赖拆到 require-dev 外独立管理、或升级到原生 asset 方案。
验证是否真走镜像，别靠感觉
执行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整结构。如果返回空、null、或报 Key not found，说明没生效。
更直接的办法：运行 composer install -vvv，看日志里下载包的 URL 是否来自 mirrors.aliyun.com 或 packagist.phpcomposer.com。小程序后端部署时，这个步骤不能跳过——CI 流水线里一次配错，整个构建就卡死在 downloading 阶段。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
