本站开发及部署说明
约 372 字大约 1 分钟
2026-10-14
pnpm docs:dev — 启动开发服务
实际执行的是 vuepress dev docs。在本地启动一个热更新的开发服务器（默认 http://localhost:8080），你日常写 md 时用它：修改 Markdown 或配置后浏览器会自动刷新，不用手动重新构建。只用于本地预览，产物不对外。
pnpm docs:build — 构建生产包
实际执行的是 vuepress build docs。把所有 Markdown 编译成纯静态的 HTML/CSS/JS，输出到 docs/.vuepress/dist/ 目录。这个 dist 就是部署用的最终产物——上传到 Cloudflare Pages 的就是它。构建比开发模式慢，因为它要做全量编译、打包和优化。
pnpm docs:preview — 本地预览生产服务
实际执行的是 vuepress preview docs。它会先启动一个本地服务器来伺服 docs:build 刚生成的 dist 目录（所以要先 build 才能 preview）。用途是在“真正的生产产物”上做上线前最后检查——因为有些问题只在构建产物里出现（比如路径错误、某些插件行为差异），开发模式下看不出来。确认没问题后再部署。
pnpm vp-update — 更新依赖
实际执行的是 vp-update 这个小工具。它会检查并把 vuepress、@vuepress/\* 以及 vuepress-theme-plume 一次性升级到最新的兼容版本并更新 package.json。主题更新比较频繁，隔段时间跑一次可以拿到新特性和修复。