Composer搜不到中文包主因未提交至Packagist、包名错误或未配置对应源；需确认vendor/name格式、大小写及分隔符，通过自定义vcs源加载Gitee/GitHub包，并使用腾讯云镜像加速。
Composer 本身不区分“国内开发的扩展”，它只认
中声明的合法包名和源（repository）。所谓“安装不了中文包”，90% 是因为没配对源、包名拼错、或包根本没发布到 Packagist 官方索引里。
为什么搜不到国内开发者写的包？
Packagist.org 默认只收录主动提交并验证过的包，且要求包名符合
格式（如
）。很多国内项目直接托管在 Gitee/GitHub，但没提交到 Packagist，也不会自动出现在搜索结果里。
搜索时别只输中文关键词（比如“微信 SDK”），要查作者名或 GitHub 仓库名（如
、
）
有些包用的是私有命名空间，比如
或
，必须知道准确
才能
部分包仅在 Gitee 上维护，未同步到 Packagist —— 这时得手动加
配置
如何让 Composer 能装 Gitee/GitHub 上的中文包？
只要项目有公开
，就能通过自定义
加载。不需要 fork 或改源码。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
在项目根目录的
里加一段：
然后运行
（注意：
必须和该仓库
里的
字段完全一致）
如果仓库没设
，Composer 会拒绝加载 —— 这是常见卡点，得先确认对方
是否规范
国内常用镜像源配置（加速 + 提高命中率）
Packagist 官方源慢且可能被拦截，但镜像源只是代理，不额外收录包。想“搜到更多中文包”，关键还是去 GitHub/Gitee 主动找，再配镜像加速安装。
推荐用腾讯云镜像：
阿里云已停止维护 Composer 镜像（2024 年起），别再用
清华源偶尔同步延迟，若
失败，可临时切回官方源试一次：
容易被忽略的细节
很多“找不到包”的问题，其实出在大小写或分隔符上 —— Composer 的
是严格区分大小写的，且不允许下划线开头、连续短横等非法字符。
✅（正确）
❌（
不是 vendor 名）
✅（有这个包）
❌（不存在，多写了
）
执行
前，先
，否则可能搜到旧缓存结果
composer.jsonvendor/nameovertrue/wechatovertruesymfonychinayiisoft/chinatopthink/think-swoolevendor/namecomposer requirerepositoriescomposer.jsonrepositoriescomposer.json
{
"repositories": [
{
"type": "vcs",
"url": "https://gitee.com/overtrue/wechat"
}
]
}composer require overtrue/wechatovertrue/wechatcomposer.json"name""name"composer.jsoncomposer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/https://mirrors.aliyun.com/composer/requirecomposer config -g repo.packagist https://packagist.orgvendor/namecomposer require topthink/think-ormcomposer require top-think/think-ormtop-thinkcomposer require overtrue/laravel-wechatcomposer require overtrue/laravel-wechat-sdk-sdkcomposer searchcomposer clear-cache