Skip to content
straight

本地构建

本文介绍如何在本地环境中构建和预览 Mizuki 博客。

环境要求

Section titled “环境要求”
  • Node.js: 18.0 或更高版本
  • pnpm: 8.0 或更高版本（推荐使用 corepack 安装）

安装依赖

Section titled “安装依赖”
Terminal window
# 启用 corepack（推荐）
corepack enable


# 克隆项目
git clone https://github.com/your-username/mizuki-blog.git
cd mizuki-blog


# 安装依赖
pnpm install

本地开发

Section titled “本地开发”

启动开发服务器：

Terminal window
pnpm dev

开发服务器将在 http://localhost:3000 启动，并支持热模块替换（HMR）。

构建项目

Section titled “构建项目”
Terminal window
pnpm build

构建完成后，静态文件将输出到 dist 目录。

预览构建结果

Section titled “预览构建结果”

构建完成后，可以在本地预览：

Terminal window
pnpm preview

预览服务器将在 http://localhost:4321 启动。

其他常用命令

Section titled “其他常用命令”
命令 说明
pnpm dev 启动开发服务器
pnpm build 构建生产版本
pnpm preview 预览构建结果
pnpm check 运行 Astro 类型检查
pnpm type-check 运行 TypeScript 类型检查
pnpm lint 代码检查
pnpm format 代码格式化
pnpm new-post 创建新文章

内容同步

Section titled “内容同步”

如果你使用内容分离功能，可以在构建前同步内容：

Terminal window
# 手动同步内容
pnpm sync-content

环境变量配置

Section titled “环境变量配置”

创建 .env 文件配置环境变量：

# 内容同步配置
ENABLE_CONTENT_SYNC=true
CONTENT_REPO_URL=https://github.com/your-username/Mizuki-Content.git
USE_SUBMODULE=false


# 番剧更新配置（可选）
BILIBILI_UID=你的B站UID

常见问题

Section titled “常见问题”

构建失败

Section titled “构建失败”

如果构建失败，请尝试：

Terminal window
# 清除缓存
rm -rf node_modules dist .astro


# 重新安装依赖
pnpm install


# 重新构建
pnpm build

端口被占用

Section titled “端口被占用”

如果端口 3000 被占用，可以在 astro.config.mjs 中修改：

server: {
  port: 3001, // 修改为其他端口
},

内存不足

Section titled “内存不足”

如果构建时出现内存不足错误：

Terminal window
# 增加 Node.js 内存限制
NODE_OPTIONS="--max-old-space-size=4096" pnpm build