LogoMkSaaS文档

IDE 设置

学习如何设置 VSCode、Cursor 或其他 IDE 以获得 MkSaaS 的最佳开发体验

MkSaaS 为流行的代码编辑器(如 VSCode 和 Cursor)提供了预配置设置,以提供最佳的开发体验。

推荐 IDE - Cursor

Cursor 是一个基于 VSCode 构建的代码编辑器,提供 AI 辅助开发功能,它对于使用 MkSaaS 模板特别有用。

用户规则

MkSaaS 在 .cursor/rules 目录中包含一些预定义的 Cursor 规则,为项目中使用的不同技术提供编码最佳实践和指导原则。这些规则有助于维护代码质量和一致性:

project-structure.mdc
development-workflow.mdc
database-state-management.mdc
ui-components.mdc
typescript-best-practices.mdc
nextjs-best-practices.mdc
react-best-practices.mdc
tailwindcss-best-practices.mdc
radix-ui-best-practices.mdc
react-hook-form-best-practices.mdc
zustand-best-practices.mdc
drizzle-orm-best-practices.mdc
date-fns-best-practices.mdc
zod-best-practices.mdc
stripe-best-practices.mdc
ai-sdk-best-practices.mdc

这些规则在 Cursor 中自动加载,可以通过从 Cursor 规则面板中选择它们来应用到您的代码中。它们提供上下文感知的指导,以改善您的开发工作流程。

文档

为了增强您的开发体验,建议将关键技术的官方文档添加到您的 Cursor 文档面板中。

考虑添加以下文档:

在 Cursor 中添加文档:

  1. 打开 Cursor 设置
  2. 进入到 Indexing & Docs 选项卡
  3. 进入到 Docs 面板
  4. 点击 + Add doc 按钮
  5. 输入文档 URL 和名称

Cursor 文档

支持 Claude Code 和 Codex

MkSaaS 模板的代码仓库内置了 claude.mdagents.md 文件,这使得项目同时支持 Claude CodeCodex 等 AI 编程助手。

这些文件为 AI 助手提供了项目的上下文信息、开发指南和最佳实践,帮助 AI 更好地理解项目结构和代码规范,从而提供更准确的代码建议和帮助。

当您使用 Claude Code 或 Codex 时,它们会自动读取这些配置文件,获得项目的完整上下文,从而提供更精准的代码生成和问题解答。

推荐 IDE 扩展

项目包含一个 .vscode/extensions.json 文件,当您在 VSCode 或 Cursor 中打开项目时,会提示您安装推荐的扩展。建议您选择立即安装,MkSaaS 与以下扩展配合使用效果最佳:

Biome

Biome 是一个强大的 JavaScript 和 TypeScript 项目格式化和代码检查工具。它是 ESLint 和 Prettier 等工具的高性能替代品,在单个快速包中提供格式化和代码检查功能。

下载 Biome 扩展

Tailwind CSS IntelliSense

Tailwind CSS IntelliSense 为 Tailwind CSS 类提供自动完成建议、代码检查和悬停预览,让 Tailwind CSS 变得更加容易使用。

下载 Tailwind CSS IntelliSense

i18n Ally

i18n Ally 是 VSCode 的强大国际化扩展,帮助您管理翻译,为键提供自动完成,并在代码中显示内联翻译。

下载 i18n Ally 扩展

i18n Ally

GitLens

GitLens 增强了 VSCode/Cursor 中的 Git 功能。它帮助您可视化代码作者身份,无缝浏览 Git 仓库,查看提交历史,并直接在编辑器中比较更改。

下载 GitLens 扩展

EditorConfig

EditorConfig 帮助在不同编辑器和 IDE 之间维护一致的编码风格。它对于强制执行一致的代码格式和缩进规则特别有用。

下载 EditorConfig 扩展

MDX

MDX 扩展为 MDX 文件提供语法高亮、智能语言功能和丰富的编辑支持。它对于在 MkSaaS 项目中处理文档和内容至关重要。

下载 MDX 扩展

推荐 MCP Server

MCP Server 可以扩展模型的能力,在 AI 编程中,MCP Server 可以提供网页调试、文档搜索等功能。MkSaaS 推荐安装下面几个 MCP Server:

推荐编辑器配置

仓库在 .vscode/settings.json 中包含预配置设置,设置了:

推荐工作流程

为了获得 MkSaaS 的最佳开发体验:

使用编辑器内置终端

在 VSCode/Cursor 中使用集成终端运行开发命令,无需切换上下文。

使用源代码控制面板

VSCode/Cursor 中的 Git 管理插件使暂存、提交和推送更改变得容易。

利用 IntelliSense

TypeScript 和 React 的内置 IntelliSense 帮助您更快地编写正确的代码。

使用 i18n Ally 进行翻译

利用 i18n Ally 直接在编辑器中管理翻译,确保您的应用程序正确国际化。

视频教程

下一步

现在您的编辑器已配置好,探索这些相关主题: