Cursor 是 AI 增强型代码编辑器，非 ThinkPHP 组件；需打开完整 TP 项目结构以提供上下文，用明确提示词（如“ThinkPHP 8.0”）生成符合规范的代码，并结合报错信息、真实代码和操作步骤辅助调试与数据库分析。
Cursor 不是 ThinkPHP 的组件，也不是 PHP 运行时的一部分，它是一款 AI 增强型代码编辑器（类似 VS Code + 内置大模型 Agent）。用它辅助开发 ThinkPHP 项目，核心是“让 AI 看得见你的代码、跑得通你的环境、读得懂你的需求”，而不是调用某个 PHP 函数或集成 SDK。
让 Cursor 看得见你的 TP 项目结构
打开整个 ThinkPHP 项目文件夹（不是只开一个 .php 文件），确保以下内容在工作区可见：
-
框架基础文件：如
thinkphp/目录（或vendor/topthink/thinkphp）、app/、config/、runtime/（可忽略但建议加到 .cursorignore） -
关键配置：特别是
config/app.php（含debug、default_timezone）、config/database.php（数据库连接参数） -
你正在写的模块：比如
app/controller/UserController.php或app/model/Order.php
Cursor 的 AI 能力依赖上下文。如果只打开一个空文件，它只能猜；而看到完整的 app/ 目录结构和 database.php，它就能准确生成符合 TP 命名规范、配置逻辑和生命周期的代码。
用 Cursor 写 TP 专用代码（非通用 PHP）
直接告诉它你是 TP 开发者，避免它按 Laravel 或原生 PHP 习惯写错：
立即学习“PHP免费学习笔记（深入）”；
- ✅ 正确提示词：“用 ThinkPHP 8.0 写一个用户登录接口，使用 Db::name('user') 查询，密码用 think\facade\Hash::check() 校验，登录成功返回 token，失败返回标准 JSON 格式”
- ❌ 避免模糊提示：“写个登录接口”（AI 可能默认用 PDO 或 Laravel Sanctum）
- ⚠️ 注意版本差异：TP 6.x 没有
cursor()方法，TP 8.0+ 才支持；提需求时明确说 “ThinkPHP 8.0”，否则 AI 可能套用 TP 6 的chunk()或手写where('id >', $lastId)
生成后，它通常会自动补全 use 语句（如 use think\facade\Db;），但你要检查是否漏了 use think\facade\Hash; 或命名空间是否匹配你的控制器路径。
用 Cursor 辅助调试与分析 TP 行为
当遇到问题时，别只问“为什么报错”，把真实上下文喂给 Cursor：
- 复制完整报错信息（含堆栈，尤其是
thinkphp/library/think/后面的路径） - 贴出对应控制器方法的全部代码（含
use、namespace、public function login()全部内容） - 说明你做了什么操作（例如：“访问 /api/login 接口，传了 {\"username\":\"a\",\"password\":\"123\"}，返回 500”）
它能快速定位常见坑，比如：
-
Db::name('user')->where(...)->cursor()在 TP 6 中根本不存在 → 提示你升级或改用分页模拟 -
paginate()在千万级表上卡死 → 建议改用cursor()（TP 8）或where('id >', $lastId)（TP 6/7） - 模型验证失败但没返回错误消息 → 检查是否漏了
->failException(true)或没 catch ValidateException
用 Cursor 操作本地 TP 数据库（无插件方案）
想查数据、看表结构、验证 SQL 效果？不用切 Navicat，用 Cursor 终端执行 + AI 解读：
- 在项目根目录下，确认已安装
pymysql或mysql-client（TP 默认用 PDO MySQL，终端命令可用mysql -u root -p -D your_tp_db） - 在 Cursor 中新建临时脚本
debug-sql.py，让 AI 生成查询代码（例如：“查 TP 的 user 表里 status=1 且 create_time 在最近 7 天的记录数”） - 点 Run 执行，终端输出结果 → AI 自动读取并告诉你：“共 247 条，其中 12 条未激活，建议加索引到 create_time 字段”
- 对慢查询，让它“生成 EXPLAIN 分析语句并解释 key_len 和 rows 含义”
注意：生产库务必用只读账号，所有命令加 LIMIT 100，避免误操作。
