composer国内配置失效主因是repo.packagist键名错误、漏写composer类型值、url缺末尾斜杠；验证需执行composer config -g repo.packagist输出完整json，空或null即失败。
Composer 在国内用不了，基本不是网络问题，而是配置写错了、权限没对上、或者根本没生效——90% 的“慢”和“报错”都卡在这三步里。
composer config -g repo.packagist 命令必须写对这三点
这条命令是全局换源最常用也最容易静默失效的操作。错一个字符，Composer 就当它不存在，还不会报错。
-
repo.packagist不能写成repos.packagist或packagist.org：多一个s，整个配置就丢进黑洞 - 第二个参数
composer是type值，不能省：漏掉它，旧版 Composer 会 fallback 到官方源，新版可能直接忽略 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠在 Composer 2.2+ 上会 404 或静默回退）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或还是 https://repo.packagist.org，说明没写进去。
宝塔/CI/计划任务里镜像不生效？确认执行用户是谁
宝塔的「PHP 管理器」、「一键部署」、「计划任务」默认以 www 用户身份运行，而 composer config -g 默认写的是你当前登录用户的配置（Windows 是 C:\Users\用户名\AppData\Roaming\Composer\config.json，Linux/macOS 是 /root/.composer/config.json）。www 根本读不到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查实际执行用户：进宝塔终端，运行
whoami；或看计划任务里写的执行用户 - 给
www单独配：用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），这样所有环境行为一致
换源后 install 还卡在 Resolving dependencies？那和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不解决依赖解析慢的问题。如果 composer install -vvv 显示卡在 Resolving dependencies 超过 10 秒，基本可以确定是本地约束太松导致求解器爆炸。
- 检查
composer.json里有没有模糊版本号，比如"monolog/monolog": "*"或"php": "^7.4 || ^8.0" - 删掉不必要的
require-dev包，尤其是一些大型工具链（如phpstan、infection） - 确认没启用已废弃的
fxp/composer-asset-plugin（常见于老 Yii2 项目），它会额外请求 Bower/NPM 源，而这些源没有国内镜像
这种情况下换镜像完全没用，得收紧约束、清缓存、禁用 xdebug，再试。
装完 Composer 后必须立刻做的三件事
新装完 Composer，别等第一次 install 再补配置——那时已经拉了一堆官方元数据，镜像等于白配。
- 换阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 开并行下载（Composer 2.2+）：
composer config -g parallel-downloads 10 - 强制 dist 模式：
composer config -g prefer-dist true
执行完立刻 composer clear-cache 清旧缓存。否则它可能还在用 packagist.org 的元数据，镜像等于白配。验证三个配置是否生效，分别运行 composer config -g repo.packagist、composer config -g parallel-downloads、composer config -g prefer-dist，都应输出对应值。
