人生进阶指南 VitePress 站点如何在本地启动开发服务器并预览生产构建【免费下载链接】upAn advanced guide which might benefit you a lot . 韩先凯的人生进阶指南 人生进阶指南 离谱的人生 人生进阶 离谱的英语学习指南/英语学习教程/英语学习/学英语项目地址: https://gitcode.com/GitHub_Trending/en/up《人生进阶指南》站点用 VitePress 构建package.json 中vitepress: 1.6.4sharp: 0.35.3。要在本地做内容修改并确认效果需要完成两条路径一是启动开发服务器实时查看改动二是构建生产产物并本地预览确认发布前站点没有构建问题。本文按项目文档 MAINTENANCE.md 和 CONTRIBUTING.md 给出的命令组织操作流程。准备条件Node 24 与依赖安装项目的版本约束写在三处.nvmrc和.node-version的内容均为24package.json 的engines字段为node: 24 25。MAINTENANCE.md 明确使用 Node.js 24CONTRIBUTING.md 给出的切换方式nvm use如果你使用其他版本管理器按 CONTRIBUTING.md 的说法用your preferred version manager切到 Node 24 即可。依赖安装必须走锁文件MAINTENANCE.md 和 CONTRIBUTING.md 都要求首次安装运行npm ci这一步只在本地node_modules/安装依赖不修改仓库文件node_modules/已在 .gitignore 中。启动开发服务器实时查看改动本地开发命令MAINTENANCE.md环境与命令一节npm run docs:dev对应 package.json 中的vitepress dev docs即以docs/为站点根目录启动 VitePress 开发服务器。服务器启动后浏览器访问的页面带有/up/前缀——这是 docs/.vitepress/config.mts 中写死的base /up/开发环境下不能省略前缀直接访问根路径下的章节地址。判断开发服务器工作正常的依据可以参考仓库自带烟测的断言tests/site.spec.mjs中文首页标题匹配人生进阶指南英文首页/up/en/标题匹配Life Level-up Guide均来自 config.mts 中两个 locale 的title打开任意导航章节时页面一级标题可见例如/up/threads/part-1/2-vocabulary的标题应匹配词汇篇中文页面可切换语言到英文页/up/en/导航中终身学习AI 学习项目实践英语专题四个入口分别指向templates/learning-state、threads/part-3/1-ai-learning、threads/part-3/2-ai-development-and-resource-layer、threads/part-1/0-cefr。本地会话凭据文件docs/assets/session.json由开发服务器的privateAssetGuard中间件拦截访问/assets/session.json会返回 404——如果你在本地误建过这个文件它不会出现在站点的任何环境里见 MAINTENANCE.md 与 config.mts。构建生产产物并本地预览确认开发态没有问题后按发布顺序执行构建与预览。这两条命令同样来自 MAINTENANCE.mdnpm run docs:build对应vitepress build docs产物输出到docs/.vitepress/dist/该目录在 .gitignore 中CI 也以此为站点产物上传路径见 .github/workflows/ci.yml 的site-previewartifact。npm run docs:preview对应vitepress preview docs在本地静态服务器中伺服刚构建出的dist/产物。仓库的烟测配置playwright.config.mjs给出了预览服务器的一个可直接复用的具体地址npm run docs:build npm run docs:preview -- --host 127.0.0.1 --port 4173其中--之后的参数透传给 VitePress preview 子命令把预览服务器绑定到127.0.0.1:4173。启动后在浏览器访问http://127.0.0.1:4173/up/应能看到与开发服务器一致的站点首页、/up/en/英文首页、任意章节页。这条命令是烟测的webServer配置超时 120 秒本地手动复现时含义相同。可选运行完整校验与烟测如果需要按项目标准完整验证站点CONTRIBUTING.md 和 MAINTENANCE.md 给出的顺序是npm run sync npm run check npm run docs:build npm run test:smokenpm run sync仅在你修改过导航docs/.vitepress/navigation.mjs、中文首页或中文词表后需要它会重新生成SUMMARY.md系列文件、根目录 README 镜像、英文词表页和 VitePresspublic分享图npm run check包含check:navigation、check:readme、check:content和 markdownlint 格式检查CI 会在生成文件出现未提交差异时失败npm run test:smokePlaywright 端到端测试自动先跑docs:build再用 preview 服务器127.0.0.1:4173/up/逐页验证导航、语言切换、本地搜索、图片 alt 和私有资源拦截。本地首次运行若缺少浏览器内核CI 的做法是npx playwright install --with-deps chromium会下载浏览器内核及系统依赖见 ci.yml本地环境reuseExistingServer为 true已有预览服务器时直接复用。限制说明Node 版本约束24 25由engines固定不要在其他大版本上构建否则与 CIactions/setup-node固定node-version: 24行为不一致。站点base为/up/且 config.mts 同时写死了sitemap.hostname与 canonical 地址https://byoungd.github.io/up/本地预览时页面里的 canonical/OG 链接仍指向线上地址这是配置决定的不影响本地渲染验证。构建与预览产生的docs/.vitepress/cache/、docs/.vitepress/dist/、test-results/、playwright-report/均为生成文件属于 Git 忽略内容不要提交MAINTENANCE.md 说明测试报告目录测试失败后可以安全清理再重新运行npm run check。【免费下载链接】upAn advanced guide which might benefit you a lot . 韩先凯的人生进阶指南 人生进阶指南 离谱的人生 人生进阶 离谱的英语学习指南/英语学习教程/英语学习/学英语项目地址: https://gitcode.com/GitHub_Trending/en/up创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
