无法直接用 composer require wechatpay/wechatpay 安装，因其未发布到 Packagist 且无稳定版本标签；须手动在 composer.json 中添加 GitHub package 源并指定真实 release 版本（如 v1.7.0），再执行 dump-autoload。
直接用 composer require wechatpay/wechatpay 会失败——这个包没上 Packagist，不是网速慢，是根本“看不见”。必须配合国内镜像 + 手动指定源才能装上。
为什么 composer require wechatpay/wechatpay 总报错？
微信支付 V3 官方 PHP SDK（wechatpay/wechatpay）托管在 GitHub，但没发布到 Packagist，也没有稳定版本标签（如 v1.7.0），导致 composer require 默认找不到可安装的版本。错误信息通常是：Could not find a matching version of package wechatpay/wechatpay。
-
wechatpay/wechatpay@dev-master可能拉得下来，但不稳定，且 autoload 配置不全，类加载常失败 - 即使加了阿里云镜像，也解决不了“源不可见”问题——镜像只加速已知包，不创造新包
- 别试
composer require wechat或wechat-sdk，这些包名不存在
正确安装方式：改 composer.json + 指定 GitHub 源
必须手动在项目根目录的 composer.json 中添加 repositories 字段，指向 GitHub 仓库，并锁定真实存在的 release 版本（截至 2026 年 7 月，推荐 v1.7.0）：
微信公众号产业研究发文助手
下载
将产业文章整理为适合微信公众号/服务号发布的研究型草稿，支持原文读取、分层摘要、产业链标的梳理、image2 海报与封面生成、正文排版、微信草稿保存、回读校验和发布前确认。适用于鹊桥产业等服务号的半导体、AI 算力、先进封装、光通信、新能源、机器人等产业链研究内容。
{
"repositories": [
{
"type": "package",
"package": {
"name": "wechatpay/wechatpay",
"version": "v1.7.0",
"source": {
"url": "https://github.com/wechatpay-contrib/wechatpay-php.git",
"type": "git",
"reference": "v1.7.0"
},
"autoload": {
"psr-4": {
"WeChatPay\": "src/"
}
}
}
}
]
}
- 注意
"type": "package"，不是"composer"——这是绕过 Packagist 的关键 -
reference必须填真实 tag 名，GitHub 上v1.7.0存在，master分支可能缺少 autoload 声明 - 装完后执行
composer dump-autoload，否则WeChatPayWeChatPay类仍会报Class not found
国内镜像只加速依赖，不解决源缺失
装 wechatpay/wechatpay 本身不走镜像，但它依赖的 guzzlehttp/guzzle、phpseclib/phpseclib 等会走镜像——所以全局配置依然必要：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（Composer 2.x） - 漏掉
-g或写成repos.packagist（多一个 s）会导致配置无效 - URL 末尾斜杠不能少：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（404） - 装完后运行
composer install --dry-run看是否识别出wechatpay/wechatpay，避免白忙
最易被忽略的是：装完不代表能用。V3 SDK 必须手动下载平台证书并配置路径，且 cert.pem 和 key.pem 不能放错顺序——这个步骤不在 Composer 流程里，但缺它连初始化都过不去。
