niumalll/docs/开发环境配置指南.md

开发环境配置指南

🖥️ 系统要求

基础环境

• 操作系统：Windows 10+, macOS 10.15+, Ubuntu 18.04+
• Node.js：>= 18.0.0
• npm：>= 8.0.0
• Git：>= 2.20.0

数据库环境

• MySQL：>= 8.0
• Redis：>= 7.0

开发工具

• IDE：VS Code（推荐）/ WebStorm / HBuilderX
• 浏览器：Chrome 90+ （开发调试）
• 微信开发者工具：最新版本（小程序开发）

🔧 环境安装

1. Node.js 安装

# 使用 nvm 管理版本（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

# 或直接下载安装
# https://nodejs.org/

2. 数据库配置

# MySQL 8.0
# 连接信息：
HOST: 129.211.213.226
PORT: 9527
USERNAME: root
PASSWORD: aiotAiot123!
DATABASE: jiebandata

# Redis（本地开发）
HOST: localhost
PORT: 6379

3. 开发工具安装

# VS Code 推荐插件
ext install ms-vscode.vscode-typescript-next
ext install Vue.volar
ext install bradlc.vscode-tailwindcss
ext install esbenp.prettier-vscode
ext install ms-vscode.vscode-eslint

🚀 项目启动

全局依赖安装

# 安装全局工具
npm install -g @vue/cli
npm install -g serve
npm install -g pm2
npm install -g sequelize-cli

项目克隆和初始化

# 克隆项目
git clone <repository-url>
cd niumall

# 安装各模块依赖
cd admin-system && npm install
cd ../backend && npm install
cd ../mini_program && npm install

启动服务

1. 后端服务

cd backend
cp .env.example .env.development
# 编辑环境变量
npm run dev
# 服务运行在 http://localhost:3001

2. 管理后台

cd admin-system
npm run dev
# 服务运行在 http://localhost:3000

3. 官网

cd website
python -m http.server 8080
# 或 npx serve . -p 8080
# 访问 http://localhost:8080

4. 小程序

cd mini_program/client-mp
npm run dev:mp-weixin
# 使用微信开发者工具打开 dist/dev/mp-weixin

🔗 开发服务地址

服务	地址	说明
后端API	http://localhost:3001	Express服务
管理后台	http://localhost:3000	Vue3应用
企业官网	http://localhost:8080	静态网站
小程序	微信开发者工具	uni-app应用

🛠️ 开发工具配置

VS Code 配置

// .vscode/settings.json
{
  "typescript.preferences.importModuleSpecifier": "relative",
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "eslint.format.enable": true,
  "vetur.validation.template": false
}

Git 配置

# 配置用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 配置提交模板
git config --global commit.template .gitmessage

🔧 常见问题解决

Node.js 版本问题

# 切换Node版本
nvm use 18
npm install

端口冲突

# 检查端口占用
netstat -ano | findstr :3000
# 杀死进程
taskkill /PID <PID> /F

数据库连接失败

1. 检查数据库服务是否启动
2. 验证连接参数
3. 检查防火墙设置
4. 确认网络连通性

依赖安装失败

# 清除缓存重新安装
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

📝 开发规范

代码提交规范

# 提交格式
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 其他修改

分支管理

• main: 主分支，生产环境代码
• develop: 开发分支，集成测试
• feature/*: 功能分支
• hotfix/*: 紧急修复分支

📧 技术支持

• 开发环境问题：dev@niumall.com
• 数据库相关：db@niumall.com
• 部署相关：ops@niumall.com
• 技术交流群：微信群-前端技术交流