mini-starter/docs/guides/setup.md

开发环境设置指南

系统要求

必需软件

软件	最低版本	推荐版本
Node.js	20.x	20.19.2
pnpm	8.x	10.18.3
PostgreSQL	15+	17
Redis	6+	7
Git	2.x	最新

推荐工具

• IDE: VS Code
• VS Code插件:
  • ES Lint
  • Prettier
  • TypeScript Vue Plugin (Volar)
  • Vitest

安装步骤

1. 克隆项目

git clone <repository-url>
cd 188-179-template-6

2. 安装 pnpm (如果未安装)

npm install -g pnpm@10.18.3

3. 安装项目依赖

pnpm install

这将安装所有工作空间的依赖，包括：

• 核心共享包
• 业务模块包
• UI组件包
• 小程序UI包
• 应用包

环境配置

PostgreSQL 配置

使用 Docker 运行 PostgreSQL

docker run -d \
  --name postgres-17 \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_DB=postgres \
  -p 5432:5432 \
  postgres:17

本地安装 PostgreSQL

1. 安装 PostgreSQL 17
2. 创建数据库用户和数据库
3. 配置连接参数

Redis 配置

使用 Docker 运行 Redis

docker run -d \
  --name redis-7 \
  -p 6379:6379 \
  redis:7

环境变量配置

创建 .env 文件（参考 .env.example）：

# 数据库配置
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/postgres

# Redis配置
REDIS_URL=redis://localhost:6379

# JWT配置
JWT_SECRET=your-jwt-secret-key-change-in-production

# MinIO配置
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=d8dai

# 应用配置
NODE_ENV=development
PORT=3000

构建共享包

在启动应用前，需要先构建共享的UI包：

# 构建所有小程序UI包
pnpm run build:mini-ui-packages

# 或者分批构建
pnpm run build:mini-ui-packages:common    # 通用组件
pnpm run build:mini-ui-packages:yongren   # 员工端组件
pnpm run build:mini-ui-packages:rencai    # 人才端组件

验证安装

运行类型检查

# 检查所有包的类型
pnpm typecheck

# 检查特定包
cd packages/core-module && pnpm typecheck

运行测试

# 运行所有测试
pnpm test

# 运行特定测试
cd packages/core-module/auth-module && pnpm test

启动开发环境

启动所有应用

pnpm dev

这将启动：

• 管理后台 (端口 8080)
• 员工小程序 H5
• 人才小程序 H5

单独启动应用

# 管理后台
pnpm run dev:web

# 员工小程序 H5
pnpm run dev:mini

# 人才小程序 H5
pnpm run dev:mini-talent

开发工具配置

VS Code 设置

创建 .vscode/settings.json：

{
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true,
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }
}

Git Hooks (可选)

安装 husky 进行代码检查：

pnpm add -D husky lint-staged
npx husky install

故障排查

依赖安装失败

# 清理缓存重新安装
rm -rf node_modules .pnpm-store
pnpm install

类型检查错误

# 清理构建产物
pnpm -r run clean

# 重新构建
pnpm build

数据库连接失败

检查：

1. PostgreSQL 是否运行
2. 连接参数是否正确
3. 防火墙设置

端口冲突

修改 .env 文件中的端口配置：

PORT=3001  # 更改为其他端口

下一步

环境配置完成后，请参阅：

• 本地开发指南
• 编码标准

---

文档版本: 1.0 最后更新: 2026-01-07