thinkphp 7.1 离线文档需通过本地 http 服务（如 python http.server 或 vs code live server）运行 index.html 才能正常使用搜索、目录和代码高亮功能，直接双击会因跨域限制失效；官方已不再维护独立 7.1 手册，应下载兼容其全部核心用法的 tp8.1.0 html 单文件版。
想在没网的时候快速查 ThinkPHP 7.1 的路由写法、数据库配置或部署要点，又不想每次打开浏览器等加载，就得把官方手册本地化——看云平台提供的离线文档包正好解决这个问题，但直接双击 HTML 文件会因跨域限制打不开交互功能。
确认手册版本与下载源
ThinkPHP 官方已不再单独维护 7.1 版本的独立手册，当前最新稳定版为 ThinkPHP 8.1.0（发布于 2026 年 6 月 20 日），其文档兼容并覆盖了 7.1 的全部核心用法。因此，请前往 https://www.kancloud.cn/thinkphp/manual-8 页面，点击底部“下载手册”按钮，选择 【HTML 单文件版】 下载。CHM 版在 Windows 上虽可运行，但不支持代码块复制和响应式缩放，不推荐。
解压后不能双击打开？必须用本地服务器启动
下载得到的 zip 包解压后，里面是一个 index.html 文件。直接双击用 Chrome 或 Edge 打开，搜索框失效、左侧目录无法展开、代码示例无法高亮——这是因为现代浏览器默认禁止 file:// 协议下的 XMLHttpRequest 请求，而看云文档依赖该机制加载章节数据。
必须启动一个最小化 HTTP 服务：打开终端，cd 进入解压后的文件夹，执行 python3 -m http.server 8000（macOS/Linux）或 py -m http.server 8000（Windows）。然后浏览器访问 http://localhost:8000，所有功能立即可用。
配置 VS Code 插件实现一键预览
方法一：安装 Live Server 插件（作者ritwickdey）
在 VS Code 扩展市场搜 “Live Server”，点击安装 → 右键 index.html → “Open with Live Server”。它会自动唤起浏览器并监听文件变更，改完文档源码立刻刷新，比手动敲 localhost 方便得多。
方法二：用内置命令（VS Code 1.85+）
打开 index.html → 按 Ctrl+Shift+P（Win）或 Cmd+Shift+P（Mac）→ 输入 “Simple HTTP Server: Start” → 回车。无需额外插件，但不支持热重载。
【注意】不要勾选 Live Server 的 “Disable cache” 选项，否则文档内嵌的 mermaid 流程图会反复加载失败，显示为空白框。
离线搜索与书签管理技巧
第一步：用 Ctrl+F 在当前页搜关键词（如 “route:clear”）→ 页面内匹配高亮清晰可见。
第二步：按 Ctrl+G 跳转到下一个匹配项，比浏览器原生查找更顺手。
第三步：遇到高频查阅页（如 “数据库读写分离配置”），右键标签页 → “添加到书签栏”，命名“TP71-db-rw”，下次点击直达。
这一步操作起来很简单，直接把文件拖进去就行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
