Block 项目开发环境配置指南

Block 采用 Dev Container + 本地 Docker 双路径，兼顾换机零配置与裸机灵活开发。

一、整体架构

上图使用 Mermaid 语法；可复制到支持 Mermaid 的编辑器查看流程图。

ASCII 示意：

宿主机
 ├── Docker Desktop
 │    ├── [Dev Container] dev (Node20 + pnpm)
 │    ├── postgres:16
 │    └── redis:7
 └── 或裸机 Node/pnpm + pnpm db:up

二、两条路径对比

项目	Dev Container（推荐）	裸机 + Docker
宿主机需装	Docker、Git、Dev Containers	Node、pnpm、Docker、Git
Node/pnpm	容器内自动对齐	本机 Corepack 安装
数据库启动	compose 随容器自动起	pnpm db:up
环境检查	pnpm check:env	同上

三、Dev Container 链路

步骤：

1. 安装 Docker Desktop + Dev Containers 扩展
2. Ctrl+Shift+P → Reopen in Container
3. 容器内 pnpm check:env → pnpm dev
4. 访问 localhost:5173 / 5174 / 3000

四、裸机链路

五、与生产环境

生产站点：http://8.210.111.112（Nginx :80 + PM2 API + Docker PG/Redis）。

六、常用命令

• pnpm check:env — 环境闸门
• pnpm db:up / db:migrate / db:seed — 裸机数据库
• pnpm dev — 启动 API + Web + Admin

小结

新机器首选 Dev Container，只需 Docker；已有 Node 环境可走裸机。两条路径最终都 converge 到 pnpm check:env → pnpm dev。