第 1 章
准备工作
在开始之前，了解项目结构、环境要求和基础概念，做好准备工作。
在正式开始安装和使用之前，我们需要做一些准备工作。
环境检查
首先确认你的开发环境满足要求：
bash检查 Node.js 版本
node --version需要 Node.js 22 或更高版本
bash检查 npm 版本
npm --version推荐使用 npm 10+
项目结构概览
注关键目录
src/content/— 所有文章、教程、页面的 Markdown 文件src/assets/images/— 封面和正文图片public/— 静态资源、附件、演示页面tools/— 本地管理控制台scripts/— 校验和测试脚本
基础概念
理解内容模型
内容以 Markdown 文件存储，元数据使用 frontmatter。每篇文章、教程、页面都是独立的文件，方便版本控制和迁移。
了解构建流程
开发时使用 npm run studio 启动实时预览。生产构建时运行 npm run build，生成纯静态的 dist/ 目录。
熟悉 Keystatic 后台
Keystatic 提供可视化编辑界面，可以在浏览器中编辑所有内容，包括上传图片和管理附件。
准备好后，进入下一章开始安装。