必须用PHP 8.0+运行ThinkPHP 8.1，手册地址为https://www.thinkphp.cn/doc/81.html，源码需从GitHub主仓库克隆8.1分支，入口为think/App.php，核心调度经路由Dispatch.php、门面facade.php及数据库Connection.php实现。
想快速掌握ThinkPHP 8.1的运行机制和扩展方式，必须直接查阅官方手册并结合GitHub仓库源码交叉验证——手册告诉你“怎么用”，源码告诉你“为什么这么设计”。当前最新稳定版为8.1（非8.0），文档与源码已按PHP 8.0+特性重构，若仍用PHP 7.4环境打开手册或加载源码，【会触发致命错误Fatal error】，务必确认本地PHP版本≥8.0。
获取ThinkPHP 8.1官方手册
打开浏览器，访问 https://www.thinkphp.cn/doc/81.html ——这是ThinkPHP官网维护的8.1专属手册页面，非旧版跳转页，也非GitHub Pages托管地址。
页面顶部有清晰的导航栏：入门 → 基础 → 核心 → 扩展 → 部署。点击任一章节后，右侧会同步显示该节所有子项，支持关键词搜索（如搜“中间件”可定位到中间件注册、执行顺序、参数传递三处说明）。
手册中所有代码块均标注了PHP版本兼容性图标，凡标有“≥8.0”的示例，不可在PHP 7.x下复制粘贴运行。
立即学习“PHP免费学习笔记（深入）”；
从GitHub获取ThinkPHP 8.1源码
进入GitHub仓库主页：https://github.com/top-think/framework，注意不是gitee镜像站，因为Gitee上的更新存在数小时延迟，且issue和PR不与主仓库同步。
点击绿色Code按钮 → Download ZIP，下载压缩包解压后，目录结构中【没有application目录】——这是框架核心库，不含默认应用模板，避免混淆。
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
若需配合IDE调试，推荐用Git克隆并检出8.1分支：
git clone https://github.com/top-think/framework.git
cd framework
git checkout 8.1
这一步不能跳过：8.1分支尚未合并进main，直接clone main将拿到开发中的8.2预览版，其路由解析器已重写，与手册描述不符。
源码阅读路径：从入口到核心调度
第一步：打开think/App.php，这是整个框架生命周期的起点。构造函数中初始化了容器、事件、配置三大基础组件，【若修改此处__construct逻辑，会导致所有Facade类无法正常代理】。
第二步：定位think/route/Dispatch.php，重点看dispatch()方法。它根据URL匹配结果决定调用控制器还是闭包，其中$this->checkCrossDomain()调用时机在路由匹配后、中间件执行前——手册“路由”章节未明确此细节，但源码注释里写了“跨域检查不应被中间件拦截”。
第三步：打开think/facade.php，观察__callStatic方法。它通过静态代理把App::run()等调用转发给容器实例，这种设计让开发者无需手动获取容器对象，但代价是IDE无法自动补全——此时应参考手册“门面”章节的替代方案：用Container::getInstance()->make('app')显式获取。
第四步：查看think/Db/Connection.php第327行prepare方法。这里用PDO::prepare()封装SQL预处理，但手册“数据库”章节未说明：当开启debug模式时，prepare会额外记录SQL执行耗时，而关闭debug后该逻辑被完全跳过——这就是为什么生产环境开启debug会拖慢查询。
