IDE 设置
学习如何设置 VSCode、Cursor 或其他 IDE 以获得 MkSaaS 的最佳开发体验
MkSaaS 为流行的代码编辑器(如 VSCode 和 Cursor)提供了预配置设置,以提供最佳的开发体验。
推荐 IDE - Cursor
Cursor 是一个基于 VSCode 构建的代码编辑器,提供 AI 辅助开发功能,它对于使用 MkSaaS 模板特别有用。
用户规则
MkSaaS 在 .cursor/rules 目录中包含一些预定义的 Cursor 规则,为项目中使用的不同技术提供编码最佳实践和指导原则。这些规则有助于维护代码质量和一致性:
这些规则在 Cursor 中自动加载,可以通过从 Cursor 规则面板中选择它们来应用到您的代码中。它们提供上下文感知的指导,以改善您的开发工作流程。
文档
为了增强您的开发体验,建议将关键技术的官方文档添加到您的 Cursor 文档面板中。
考虑添加以下文档:
- MkSaaS 文档 - MkSaaS 文档
- Next.js 文档 - 核心框架功能
- Drizzle ORM 文档 - 数据库操作
- Tailwind CSS 文档 - 样式
- Radix UI 文档 - UI 组件
- Shadcn/ui 文档 - 预构建组件
- Magic UI 文档 - Magic UI 组件
- Dice UI 文档 - Dice UI 组件
- Better Auth 文档 - 身份验证
- Resend 文档 - 邮件和邮件订阅功能
- Stripe 文档 - 支付处理
- Vercel AI SDK 文档 - AI 功能
- Vercel AI Gateway 文档 - AI 网关
- Vercel AI Elements 文档 - AI 组件
- Zod 文档 - 模式验证
- Zustand 文档 - 状态管理
- Next-Intl 文档 - 国际化
- Fumadocs 文档 - 文档
- Nuqs 文档 - 类型安全的搜索参数状态管理器
- Next-Safe-Action 文档 - 安全操作
在 Cursor 中添加文档:
- 打开 Cursor 设置
- 进入到
Indexing & Docs选项卡 - 进入到
Docs面板 - 点击
+ Add doc按钮 - 输入文档 URL 和名称

支持 Claude Code 和 Codex
MkSaaS 模板的代码仓库内置了 claude.md 和 agents.md 文件,这使得项目同时支持 Claude Code 和 Codex 等 AI 编程助手。
这些文件为 AI 助手提供了项目的上下文信息、开发指南和最佳实践,帮助 AI 更好地理解项目结构和代码规范,从而提供更准确的代码建议和帮助。
当您使用 Claude Code 或 Codex 时,它们会自动读取这些配置文件,获得项目的完整上下文,从而提供更精准的代码生成和问题解答。
推荐 IDE 扩展
项目包含一个 .vscode/extensions.json 文件,当您在 VSCode 或 Cursor 中打开项目时,会提示您安装推荐的扩展。建议您选择立即安装,MkSaaS 与以下扩展配合使用效果最佳:
Biome
Biome 是一个强大的 JavaScript 和 TypeScript 项目格式化和代码检查工具。它是 ESLint 和 Prettier 等工具的高性能替代品,在单个快速包中提供格式化和代码检查功能。
Tailwind CSS IntelliSense
Tailwind CSS IntelliSense 为 Tailwind CSS 类提供自动完成建议、代码检查和悬停预览,让 Tailwind CSS 变得更加容易使用。
GitLens
GitLens 增强了 VSCode/Cursor 中的 Git 功能。它帮助您可视化代码作者身份,无缝浏览 Git 仓库,查看提交历史,并直接在编辑器中比较更改。
推荐 MCP Server
MCP Server 可以扩展模型的能力,在 AI 编程中,MCP Server 可以提供网页调试、文档搜索等功能。MkSaaS 推荐安装下面几个 MCP Server:
- Context7 - Context7 MCP Server
- Chrome DevTools - Chrome DevTools MCP Server
推荐编辑器配置
仓库在 .vscode/settings.json 中包含预配置设置,设置了:
推荐工作流程
为了获得 MkSaaS 的最佳开发体验:
使用编辑器内置终端
在 VSCode/Cursor 中使用集成终端运行开发命令,无需切换上下文。
使用源代码控制面板
VSCode/Cursor 中的 Git 管理插件使暂存、提交和推送更改变得容易。
利用 IntelliSense
TypeScript 和 React 的内置 IntelliSense 帮助您更快地编写正确的代码。
使用 i18n Ally 进行翻译
利用 i18n Ally 直接在编辑器中管理翻译,确保您的应用程序正确国际化。
视频教程
下一步
现在您的编辑器已配置好,探索这些相关主题:
MkSaaS文档