常见问题

为什么线上没变化？

浏览器跑的是构建后的 .vitepress/dist/，不是你写的 .md 源文件。每次改完必须：

npm run build      # 重新生成 dist/

然后把新的 dist/ 内容上传覆盖到服务器，最后强制刷新浏览器（Ctrl/Cmd + Shift + R）。

目录不显示新文章？

检查 .vitepress/config.ts 里 themeConfig.sidebar 是否把新页面加进去了——VitePress 的目录由配置文件定义（和 HonKit 用 SUMMARY.md 不同）。

中文乱码？

确保 .md 文件以 UTF-8 编码保存，并在 config.ts 里设置 lang: 'zh-CN'。

和我的 MC 注册站冲突吗？

不冲突。register.otech.top 是注册站，docs.otech.top 是本说明站，Nginx 按域名分流，各自独立目录。