须先查 Packagist 和 GitHub 确认 TP8 官方已发布带 alpha 后缀的真实版本(如 8.1.0-alpha.1),再执行 composer config minimum-stability dev、删 vendor 与 lock 文件,最后用 composer require topthink/think:8.1.0-alpha.1 安装。

想装 TP 的 alpha 版,不是加个 @alpha 就完事——它得包本身真打了 alpha tag,还得你项目配置、锁文件、autoload 全部配合,否则装了也跑不起来。
怎么确认 TP 官方发布了 alpha 版本
TP8 当前稳定版是 8.0.5(2026 年 4 月发布),但 alpha 版本不会出现在 composer create-project topthink/think 默认列表里。必须手动查:
- 打开 https://www.php.cn/link/ba3a0adbebf2cfb367817fad99c6fb13,点 “Versions” 标签页,找带
alpha、beta或-RC后缀的版本(如8.1.0-alpha.1) - 进 GitHub 仓库
topthink/think的 Releases 页面,确认有对应 tag 且未标记为 “draft” - 别信“听说有新功能”,
composer show topthink/think --all才是真实可用版本列表
装 alpha 版必须改 minimum-stability
composer require topthink/think:@alpha 会失败,除非你已放开稳定性策略。原因:alpha 属于 dev 级别,而 Composer 默认只认 stable。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 在项目根目录执行:
composer config minimum-stability dev - 同时建议加上:
composer config prefer-stable true,避免其他依赖也被拉成 dev 分支 - 改完立刻删掉
vendor/和composer.lock,再运行composer install—— 旧 lock 文件会锁死 stable 版本,不删就无效 - 不要全局配:
composer config -g minimum-stability dev,这会让所有项目都暴露在不稳定依赖中
create-project 不支持直接装 alpha
composer create-project topthink/think tp8 @alpha 会报错:Could not find package topthink/think with version @alpha。因为 create-project 只接受具体版本号或分支名,不解析稳定性别名。
- 正确做法:先用
create-project拉一个干净骨架(如composer create-project topthink/think tp8 8.0.5) - 再进目录,执行:
composer require topthink/think:8.1.0-alpha.1(把版本号换成你查到的真实 alpha tag) - 如果作者只打了
dev-main分支但没发 alpha tag,就得用:composer require topthink/think:dev-main as 8.1.0-alpha.1,手动 alias - 注意:
dev-main是代码最新快照,可能含未测功能或破坏性变更;@alpha至少经过基础验证,更可控
装完跑不起来?重点检查三处
alpha 版本的坑不在安装过程,而在运行时环境适配:
-
php think run报Command "run" is not defined?说明框架核心类没加载——执行composer dump-autoload -o强制重生成映射 - 访问 404 或白屏?检查
public/index.php是否仍引用旧版 autoload 路径,或APP_DEBUG=true被关了导致错误静默 - 报
Class 'think\Foo' not found?用composer show topthink/think确认实际安装的 commit hash,再比对 GitHub 上该 alpha tag 的composer.json中autoload配置是否新增了命名空间路径 - 最易忽略的一点:TP8 alpha 可能要求 PHP ≥ 8.2(当前稳定版只要 8.1),
php -v和composer diagnose都得看

















