本地启动与发布
本地启动
bash
npm install
npm run docs:dev默认会启动 VitePress 本地站点，用来预览知识库页面。
构建检查
bash
npm run docs:build构建成功后会输出静态文件，用来确认导航、侧边栏和页面链接都正常。
常用场景
| 场景 | 命令 | 说明 |
|---|---|---|
| 日常写作 | npm run docs:dev | 边写边看效果 |
| 交付前检查 | npm run docs:build | 检查是否能完整构建 |
| 本地预览构建结果 | npm run docs:preview | 复核线上效果 |
建议流程
- 先从对应栏目首页进入，确认新内容属于哪一层。
- 新建页面后补到对应侧边栏，不让内容变成孤岛。
- 交付前至少跑一次构建，避免把坏链接留下来。