composer require overtrue/wechat 超时或失败是因为默认访问境外 Packagist 官方源（https://packagist.org）国内直连极慢或超时，需切换阿里云等国内镜像源并执行 composer clear-cache 验证生效。
为什么 composer require overtrue/wechat 会超时或失败？
不是包不存在，而是默认走 Packagist 官方源（https://packagist.org），国内直连极慢甚至超时，composer require 卡住或报 Could not find package 很可能只是网络没通。微信 SDK 本身（如 overtrue/wechat）完全托管在 Packagist，无需额外配置仓库——只要源能连上，就能装。
如何确认并切换到可用的国内镜像源？
先检查当前全局源：
composer config -g repo.packagist
若显示 https://packagist.org 或为空，就该换镜像了。推荐用阿里云源（稳定、同步及时）：
- 临时切换（仅本次命令）：
composer require overtrue/wechat:~5.0 -vvv --repository=https://mirrors.aliyun.com/composer/ - 永久切换（推荐，一劳永逸）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云源备选：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
执行后运行 composer config -g repo.packagist 确认输出已变。注意：别用过期的“华为云”或“网易云”镜像，部分已停更，会导致拉不到新版包。
装完发现 vendor/autoload.php 加载不了类？
国内源只解决下载问题，不解决自动加载失效。常见漏点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
vendor/autoload.php路径写错，尤其在 CLI 脚本里用了相对路径，应改用require_once dirname(__DIR__) . '/vendor/autoload.php'; - 装完没触发 autoloader 重建，特别是 Docker 构建或部署后，补一句
composer dump-autoload -o - 项目根目录下真没
vendor/？检查是否误加了--no-install或--dry-run
验证最简单方式：在入口脚本加 var_dump(class_exists('Overtrue\WeChat\Kernel\ServiceContainer'));，输出 true 才算真正加载成功。
哪些 WeChat SDK 包能直连国内源安装？
只有明确发布在 Packagist 上的包才行。目前可直接 composer require 的主流包包括：
-
overtrue/wechat:~5.0（公众号/小程序通用，PHP ≥ 7.2） -
easywechat/easywechat:^6.0（Laravel 友好，PHP ≥ 8.0） -
overtrue/laravel-wechat:^7.2（Laravel 专用封装）
但这些不行：wechat/pay、wechatpay/wechatpay、pay-php-sdk —— 它们不在 Packagist，换再快的源也没用，必须手动引入或配 repositories。
国内源能加速，但不能绕过版本约束和 PHP 兼容性检查。装之前务必确认 php -v 输出符合目标 SDK 要求，否则即使源飞快，也会在 autoload 阶段报 fatal error。
