快速开始

本机环境

• Node 22.22.1（仓库根目录 .nvmrc）
• pnpm 10.15.0
• MySQL 8（本地或测试机）

cp jy-site/.env.example jy-site/.env
cp jy-admin/.env.example jy-admin/.env
# 两个 .env 的 DATABASE_* 指向同一库
# jy-admin 还需 SESSION_SECRET（至少 32 字符）

cd jy-site && pnpm install && pnpm dev      # 常见端口 5175
cd jy-admin && pnpm install && pnpm dev     # 5174

初始化库

mysql -u root -p < jy-site/blog_site.sql

blog_site.sql 里的 users.password_hash 是占位值，不能登录。部署管理端时需要写入真实 bcrypt 哈希。

构建命令

命令	用途
cd jy-site && pnpm build	只跑 Vite，缺搜索索引和 sitemap 修补
cd jy-site && pnpm build:static	线上静态包，应使用这个
cd jy-admin && pnpm build	Next.js standalone 产物在 .next/standalone

密码里如果有 #，.env 必须加引号，否则会被当成注释：

DATABASE_PASSWORD="your#password"

代码格式化（Biome）

配置在仓库根目录 biome.json。初始化（已完成，不必再跑）：

pnpm exec biome init

日常命令（都在仓库根目录）：

命令	用途
pnpm format	格式化全部文件并写回
pnpm format:check	只检查格式，不改文件
pnpm lint	检查 lint
pnpm lint:fix	lint 并应用安全修复
pnpm check:biome	同时检查 format、lint、import 排序
pnpm exec biome check --write	检查并写回（format + 安全 lint 修复 + import 排序）

只处理某个目录或文件：

pnpm exec biome format --write jy-admin
pnpm exec biome format --write jy-site/src/lib
pnpm exec biome format --write path/to/file.ts

jy-site 里仍有 Prettier（cd jy-site && pnpm format），仓库级格式化以根目录 Biome 为准。