快速开始

本指南将帮助你在本地快速运行 docsblog-app 项目。

环境要求

• Node.js 22.x 或更高版本
• pnpm 10.x（项目使用 pnpm 作为包管理器）

确认环境版本：

node -v   # v22.x+
pnpm -v   # 10.x+

如果尚未安装 pnpm，可通过以下方式安装：

corepack enable
corepack prepare pnpm@latest --activate

克隆与安装

git clone <your-repo-url> docsblog-app
cd docsblog-app
pnpm install --frozen-lockfile

--frozen-lockfile 确保依赖版本与 pnpm-lock.yaml 完全一致，避免意外升级。

配置环境变量

复制环境变量模板并根据需要修改：

cp .env.example .env

默认配置即可满足本地开发需求，无需额外修改。

启动开发服务器

pnpm run dev

开发服务器将在 http://localhost:3005 启动。

首次访问

• 访问 http://localhost:3005 进入首页（默认英文界面）
• 访问 http://localhost:3005/zh-hans/ 进入中文界面
• 英文（en）为默认语言，URL 中不显示语言前缀；中文需要 /zh-hans/ 前缀

Admin 后台入口

开发模式下，顶部导航栏会自动显示 Admin 入口链接，点击即可进入后台管理界面。

Admin 后台仅在本地开发环境可用，生产环境默认关闭。

常用命令