Composer安装ThinkPHP5扩展本质是安装符合PSR-4规范的第三方包，非中心化插件市场；装不上常见因未发布至Packagist、autoload未正确声明PSR-4映射或依赖版本不兼容。
Composer 安装 ThinkPHP 5 扩展插件，本质是安装符合 PSR-4 自动加载规范的第三方包，不是“TP5 插件市场”式安装——TP5 本身没有中心化插件体系，所有扩展都走标准 Composer 包流程。
为什么 composer require 装不上某些“TP5 插件”？
常见原因有三个：
- 该包未发布到 Packagist，也未在
composer.json中配置私有仓库（repositories） - 包的
autoload没正确声明 PSR-4 映射，导致 TP5 的 Loader 找不到类（例如写成"psr-4": {"": "src/"}却没带命名空间前缀） - 包依赖了不兼容的 PHP 或 ThinkPHP 版本，而
composer require默认拒绝降级或跳过约束（可通过--ignore-platform-reqs强行装，但不推荐）
composer.json 中必须确认的 TP5 兼容项
旧版 ThinkPHP 5.0.x 和 5.1.x 对 Composer 的要求差异较大，容易因配置错位导致自动加载失败：
- TP5.0 使用自己的
thinkphp/library/think/Loader.php，只支持psr-4和classmap，不识别files类型的全局函数加载 - TP5.1+ 已完全切换为 Composer 原生 autoloader，支持
files，但需确保包的autoload.files指向的是可直接require的 PHP 文件（如functions.php） - 务必检查扩展包的
composer.json中require字段是否含"topthink/framework": "^5.0"或"^5.1"，版本号不匹配会导致 Composer 拒绝安装
手动注册非 Packagist 包（如 GitHub 仓库）
很多 TP5 扩展只托管在 GitHub，没提交到 Packagist。此时不能只靠 composer require vendor/name，必须显式添加仓库源：
立即学习“PHP免费学习笔记（深入）”；
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/username/think-wechat"
}
],
"require": {
"username/think-wechat": "dev-master"
}
}
注意点：
-
url必须是 Git 仓库地址，且该仓库根目录下要有合法的composer.json -
require中的包名（username/think-wechat）必须与目标仓库composer.json里的name字段完全一致 - 分支名写
dev-master或dev-develop时，Composer 默认不更新 —— 需加--prefer-source或删掉vendor后重装
装完后还要手动加载？
绝大多数正规扩展包装完即用，但以下两类情况需要额外操作：
- 提供命令行指令（如
php think optimize:route）的包，需确认其composer.json中extra.think-command是否已注册，否则php think不识别新命令 - 含服务提供者（Service Provider）的包（如
think-swoole），需在application/provider.php中手动追加类名，TP5 不自动扫描providers数组 - 使用
files加载辅助函数的包（如topthink/think-helper），仅 TP5.1+ 支持，TP5.0 会静默忽略 —— 此时得改用Loader::addNamespace()手动注册
最常被忽略的一点：TP5 的自动加载缓存（runtime/cache/ 下的 autoload_*.php）不会随 composer install 自动刷新。装完新包后，务必清空 runtime/cache/ 目录，否则旧类映射仍生效，新类报 Class not found。
