Skip to content

环境准备与命令

本文档说明开发环境配置标准以及开发服务器的生命周期管理规范。


  • Node.js 运行环境: ^18.18.0>=20.0.0
  • 包管理器: npm
  • 支持操作系统: Windows / macOS / Linux

在项目根目录下执行:

Terminal window
npm install

按照项目开发规范,本地开发服务器应使用后台管理模式,并通过锁文件控制进程。

推荐使用后台模式启动:

Terminal window
astro dev --background

astro 未在全局环境变量 PATH 中,可执行以下命令:

Terminal window
node node_modules/astro/bin/astro.mjs dev --background

查询进程 PID 与当前监听端口:

Terminal window
astro dev status

实时输出服务器运行日志:

Terminal window
astro dev logs

优雅关闭进程并释放端口:

Terminal window
astro dev stop

在提交变更或发布前,可调用以下脚本校验代码与产物:

Terminal window
# 扫描校验指定目录下的 MDX 语法与 KaTeX 编译是否符合规范
node scripts/scan-mdx.mjs src/content/docs/collections/<collection>/<book>
# 执行全书 EPUB 打包流程
node scripts/build-epub.mjs