Cursor 企业级 Go 迁移需显式提供工程约束而非仅给目标框架名，核心是类型安全、依赖注入、测试节奏三大锚点，并通过 Project File 驱动跨文件一致性重构。
cursor 在企业级 go 项目迁移中，不是“写得快”就等于“迁得稳”。真正提速的关键，在于让 ai 理解你的工程约束，而不是让它自由发挥。
为什么直接让 Cursor “把 Express 迁到 Encore.ts” 会失败
常见错误现象：You've reached your trial request limit、生成代码编译失败、HTTP 路由注册缺失、中间件顺序错乱。这不是 AI 能力问题，而是上下文喂得太模糊。
Go 项目迁移的核心约束是：类型安全边界、依赖注入方式、测试驱动节奏。AI 不会主动识别 main.go 里 http.ListenAndServe 被替换成 encore.App 后，哪些中间件要重写为 encore.Middleware 类型。
- 必须显式提供迁移锚点：比如指定
api/目录为 HTTP 接口层，svc/为服务层，model/为数据结构层 - 不能只给目标框架名（如
Encore.ts），而要给出可执行的最小契约，例如：“所有 handler 必须返回encore.HTTPError或encore.JSON，禁止使用net/http原生 ResponseWriter” - 性能影响：未约束的迁移常导致生成大量
interface{}和运行时反射，使原本 9 倍的性能优势缩水至 2–3 倍
用 Project File 驱动跨文件重构，而非单次聊天
真实场景下，一个“用户登录迁移”涉及至少 5 个文件：api/auth/handler.go、svc/auth/service.go、model/user.go、internal/middleware/auth.go、test/auth_test.go。靠 Cmd+I 一次提问无法保证一致性。
正确做法是先建一个 migration/login-to-encore.md 文件，内容结构如下：
## Step 1: API Layer - Replace `http.HandlerFunc` with `encore.Handler` - Use `encore.Req` for request binding, not `json.Unmarshal` - Return `encore.JSON(200, resp)` or `encore.HTTPError(401, "invalid token")` <h2>Step 2: Service Layer</h2><ul><li>Keep existing <code>Login(ctx, req)</code> signature</li><li>Extract auth logic into new <code>auth.VerifyToken()</code> function</li></ul><h2>Step 3: Test</h2><ul><li>Rewrite <code>TestLoginSuccess</code> to use <code>encore.TestServer</code></li><li>Assert on <code>encore.HTTPError.Code</code>, not status code string
然后在 Cursor 中选中该文件，按 Cmd+I 并输入：“按以上步骤迁移 login 功能，跳过已标注 [SKIP] 的文件”。AI 会严格按文档路径执行，不会擅自改动 model/user.go 中的字段标签。
避免 YOLO 模式在 Go test 中误删关键逻辑
YOLO 模式开启后，Cursor 默认允许运行 go test ./...，但企业级 Go 项目往往有以下陷阱：
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
-
go test ./...会执行integration/下的慢速测试，拖垮 Agent 循环，建议限定为go test -short ./api/... - 某些测试依赖本地 Redis 或 PostgreSQL，AI 自动运行时会因连接失败反复重试，最终超时退出——应在
go.mod同级加.cursorignore，写入integration/ e2e/ fixtures/ - Go 的
//go:build构建约束被忽略，AI 可能将linux-only工具函数迁移到 Windows 兼容模块中，引发构建失败
实际配置建议：在 Cursor Settings > AI > Commands 中，将 “Allowed test commands” 改为：
go test -short ./api/... go test -short ./svc/... go test -run ^TestValidate.*$ ./model/...
Chat history 迁移不是可选项，而是上下文资产
你在老项目中和 Cursor 讨论过的 37 次 DB 迁移方案、12 次并发模型优化，全存在本地 SQLite 里。换机器或新建工作区后，这些决策链就断了——AI 再次面对相同模块时，会重复提出已被否决的设计（比如“用 channel 替代 mutex”）。
必须用 cursor-chat-transfer 工具导出，路径是：
macOS：~/Library/Application Support/Cursor/User/workspaceStorage/ 下对应工作区的 UUID 文件夹 → 找 state.vscdb
导出后不要直接导入新环境，先用脚本过滤掉含 TODO: fix later 或 WIP 的对话，否则 AI 会把半成品当规范执行。
