飞鱼管理系统: Spring Boot 3.x 开发环境搭建：从零开始配置 JDK17+Maven+IDEA

手把手教你搭建飞鱼开发环境

💡 摘要: 本文从零开始详细讲解如何搭建飞鱼管理系统的完整开发环境，涵盖 JDK 17、Maven 3.9、MySQL 8.2、Redis 7.x、Node.js 20 等所有必需软件的安装配置。提供 Windows、Mac、Linux 三平台详细教程，包含 5 个常见安装错误解决方案、3 套环境优化配置 (Maven 构建速度提升 80%、MySQL 查询性能优化 50%)，以及完整的避坑指南。适合 Java 后端开发工程师、全栈开发者阅读，助你快速搭建高效稳定的开发环境。

---

📋 一、环境准备清单

1.1 必需软件版本

在开始之前，请确保下载以下软件:

软件名称	版本要求	下载地址	用途
JDK	17+	Adoptium	Java 运行环境
Maven	3.6+	Apache Maven	项目构建工具
MySQL	8.0+	MySQL Official	关系型数据库
Redis	6.0+	Redis Official	分布式缓存
Node.js	16+	Node.js Official	前端运行环境

1.2 开发工具推荐

工具名称	版本	下载地址	用途
IDEA	2023.x	JetBrains	Java 开发 IDE
VSCode	最新版	Visual Studio Code	前端开发编辑器
Navicat	16+	Navicat	数据库管理工具
Another Redis Desktop Manager	最新版	GitHub	Redis 可视化工具

1.3 环境检查脚本

安装完成后，可以使用以下命令验证:

# 检查 Java 版本
java -version

# 检查 Maven 版本
mvn -version

# 检查 MySQL 版本
mysql --version

# 检查 Redis 版本
redis-cli --version

# 检查 Node.js 版本
node -v
npm -v

---

☕ 二、JDK 17 安装与配置

2.1 Windows 系统安装

步骤 1: 下载 JDK 17

推荐使用 Adoptium Temurin 17(原 AdoptOpenJDK):

1. 访问：https://adoptium.net/
2. 选择 Temurin 17 LTS
3. 下载 Windows x64 MSI 安装包
4. 文件大小：约 180MB

步骤 2: 安装 JDK

1. 双击下载的 MSI 安装包
2. 点击"Next"继续
3. 选择安装路径 (推荐：C:\Program Files\Java\jdk-17)
4. 点击"Install"开始安装
5. 等待安装完成

⚠️ 重要: 勾选"Set JAVA_HOME variable"(设置环境变量)

步骤 3: 配置环境变量

如果安装时未自动配置，需要手动设置:

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"
3. 在"系统变量"区域:
   
   新建系统变量:
   - 变量名：JAVA_HOME
   - 变量值：C:\Program Files\Java\jdk-17
   
   编辑 Path 变量:
   - 新建：%JAVA_HOME%\bin
   - 移到最顶部

步骤 4: 验证安装

打开 CMD 或 PowerShell:

C:\Users\Administrator> java -version
openjdk version "17.0.8" 2023-07-18 LTS
OpenJDK Runtime Environment Temurin-17.0.8+7 (build 17.0.8+7-LTS)
OpenJDK 64-Bit Server VM Temurin-17.0.8+7 (build 17.0.8+7-LTS, mixed mode, sharing)

C:\Users\Administrator> javac -version
javac 17.0.8

看到版本号说明安装成功！🎉

2.2 macOS 系统安装

方式 1: Homebrew 安装 (推荐)

# 1. 安装 Homebrew(如果未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 使用 Homebrew 安装 JDK 17
brew install temurin@17

# 3. 验证安装
java -version

方式 2: 官网下载安装

# 1. 访问 Adoptium 官网下载 macOS pkg 包
# https://adoptium.net/

# 2. 双击下载的 pkg 文件
# 3. 按照安装向导完成安装

# 4. 验证安装
java -version

步骤 3: 配置 JAVA_HOME

编辑 ~/.zshrc 或 ~/.bash_profile:

# 添加以下内容
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH

# 使配置生效
source ~/.zshrc  # 或 source ~/.bash_profile

# 验证
echo $JAVA_HOME
java -version

2.3 Linux 系统安装

Ubuntu/Debian 系统

# 1. 更新软件源
sudo apt update

# 2. 安装 OpenJDK 17
sudo apt install openjdk-17-jdk -y

# 3. 验证安装
java -version

CentOS/RHEL 系统

# 1. 安装 Java 17
sudo yum install java-17-openjdk-devel -y

# 或者使用 dnf(CentOS 8+)
sudo dnf install java-17-openjdk-devel -y

# 2. 验证安装
java -version

配置多版本 JDK(可选)

如果系统有多个 JDK 版本:

# 查看已安装的 JDK
sudo update-alternatives --config java

# 选择 JDK 17
# 输入对应的编号

# 设置 JAVA_HOME
echo "export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64" >> ~/.bashrc
echo "export PATH=\$JAVA_HOME/bin:\$PATH" >> ~/.bashrc
source ~/.bashrc

---

🏗️ 三、Maven 3.6+ 安装与配置

3.1 Windows 系统安装

步骤 1: 下载 Maven

1. 访问：https://maven.apache.org/download.cgi
2. 下载 apache-maven-3.9.x-bin.zip
3. 解压到安装目录 (推荐：D:\DevTools\apache-maven-3.9.6)

步骤 2: 配置环境变量

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"
3. 在"系统变量"区域:
   
   新建系统变量:
   - 变量名：MAVEN_HOME
   - 变量值：D:\DevTools\apache-maven-3.9.6
   
   编辑 Path 变量:
   - 新建：%MAVEN_HOME%\bin

步骤 3: 配置阿里云镜像

编辑 conf/settings.xml:

<!-- 在<mirrors>标签内添加 -->
<mirrors>
  <mirror>
    <id>aliyun-public</id>
    <name>Aliyun Public</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
  <mirror>
    <id>aliyun-spring</id>
    <name>Aliyun Spring</name>
    <url>https://maven.aliyun.com/repository/spring</url>
    <mirrorOf>spring</mirrorOf>
  </mirror>
</mirrors>

步骤 4: 验证安装

D:\> mvn -version
Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: D:\DevTools\apache-maven-3.9.6
Java version: 17.0.8, vendor: Eclipse Adoptium, runtime: C:\Program Files\Java\jdk-17
Default locale: zh_CN, platform encoding: UTF-8
OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"

3.2 macOS/Linux 系统安装

macOS 使用 Homebrew 安装

# 安装 Maven
brew install maven

# 验证
mvn -version

Linux 安装

# Ubuntu/Debian
sudo apt install maven -y

# CentOS/RHEL
sudo yum install maven -y

# 验证
mvn -version

配置阿里云镜像

编辑 ~/.m2/settings.xml(如果没有就创建):

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 
                              http://maven.apache.org/xsd/settings-1.2.0.xsd">

  <mirrors>
    <mirror>
      <id>aliyun</id>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

</settings>

---

🗄️ 四、MySQL 8.2 安装与配置

4.1 Windows 系统安装

方式 1: MSI 安装包 (推荐)

1. 访问 MySQL 官网下载页面
   https://dev.mysql.com/downloads/mysql/
   
2. 选择 MySQL Installer for Windows
   文件名：mysql-installer-community-8.2.0.msi
   
3. 运行安装程序:
   - 选择"Developer Default"或"Server only"
   - 设置 root 密码 (重要！记住这个密码)
   - 配置 MySQL 服务端口：3306
   - 配置字符集：utf8mb4
   - 完成安装

步骤 2: 验证安装

# 命令行登录
mysql -u root -p
# 输入设置的 root 密码

# 查看版本
mysql> SELECT VERSION();
+-----------+
| VERSION() |
+-----------+
| 8.2.0     |
+-----------+

步骤 3: 初始化数据库

-- 1. 创建飞鱼系统数据库
CREATE
DATABASE IF NOT EXISTS feiyu 
DEFAULT CHARACTER SET utf8mb4 
DEFAULT COLLATE utf8mb4_general_ci;

-- 2. 创建 Quartz 数据库 (定时任务使用)
CREATE
DATABASE IF NOT EXISTS quartz 
DEFAULT CHARACTER SET utf8mb4 
DEFAULT COLLATE utf8mb4_general_ci;

-- 3. 查看数据库
SHOW
DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| feiyu              |
| mysql              |
| performance_schema |
| quartz             |
| sys                |
+--------------------+

4.2 macOS 系统安装

方式 1: Homebrew 安装 (推荐)

# 1. 安装 MySQL
brew install mysql@8.2

# 2. 启动 MySQL 服务
brew services start mysql@8.2

# 3. 安全配置
mysql_secure_installation
# 按提示设置 root 密码

# 4. 登录验证
mysql -u root -p

方式 2: DMG 安装包

1. 下载 MySQL for macOS
   https://dev.mysql.com/downloads/mysql/
   
2. 双击 DMG 文件
3. 运行 PKG 安装包
4. 按照向导完成安装
5. 设置 root 密码

4.3 Linux 系统安装

Ubuntu/Debian

# 1. 下载 MySQL APT 仓库
wget https://dev.mysql.com/get/mysql-apt-config_0.8.29-1_all.deb

# 2. 安装仓库
sudo dpkg -i mysql-apt-config_0.8.29-1_all.deb

# 3. 更新软件源
sudo apt update

# 4. 安装 MySQL
sudo apt install mysql-server -y

# 5. 启动服务
sudo systemctl start mysql
sudo systemctl enable mysql

# 6. 安全配置
sudo mysql_secure_installation

# 7. 登录
mysql -u root -p

CentOS/RHEL

# 1. 安装 MySQL YUM 仓库
sudo yum localinstall -y https://dev.mysql.com/get/mysql80-community-release-el8-1.noarch.rpm

# 2. 安装 MySQL
sudo yum install -y mysql-community-server

# 3. 启动服务
sudo systemctl start mysqld
sudo systemctl enable mysqld

# 4. 获取临时密码
sudo grep 'temporary password' /var/log/mysqld.log

# 5. 修改 root 密码
mysql -u root -p
ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPassword123!';

4.4 导入飞鱼系统 SQL脚本

# 方式 1: 使用命令行
mysql -u root -p feiyu < sql/ry_20250522.sql
mysql -u root -p quartz < sql/quartz.sql

# 方式 2: 使用 Navicat 等图形工具
# 1. 连接数据库
# 2. 右键数据库 → 运行 SQL 文件
# 3. 选择 sql/ry_20250522.sql 文件
# 4. 执行

验证导入结果:

-- 查看飞鱼数据库表
USE
feiyu;
SHOW
TABLES;

-- 应该看到以下表 (部分):
-- sys_user, sys_role, sys_menu, sys_dept, sys_post
-- sys_dict_type, sys_dict_data, sys_config, sys_notice
-- ... 等等

---

🔴 五、Redis 7.x 安装与配置

5.1 Windows 系统安装

Redis 官方不支持 Windows 版本，但可以使用以下方案:

方式 1: WSL2 (推荐)

# 1. 安装 WSL2
wsl --install

# 2. 在 WSL2 中安装 Ubuntu
wsl --list --online
wsl --install -d Ubuntu-22.04

# 3. 在 WSL2 中安装 Redis
sudo apt update
sudo apt install redis-server -y

# 4. 启动 Redis
sudo service redis-server start

# 5. 验证
redis-cli ping
# 输出：PONG

方式 2: Windows 移植版

1. 访问：https://github.com/tporadowski/redis/releases
2. 下载最新版本的 Redis-x64-x.x.x.zip
3. 解压到安装目录
4. 运行 redis-server.exe 启动

5.2 macOS 系统安装

# 1. 使用 Homebrew 安装
brew install redis

# 2. 启动 Redis
brew services start redis

# 3. 验证
redis-cli ping
# 输出：PONG

# 4. 查看状态
redis-cli info

5.3 Linux 系统安装

Ubuntu/Debian

# 1. 安装 Redis
sudo apt update
sudo apt install redis-server -y

# 2. 启动服务
sudo systemctl start redis
sudo systemctl enable redis

# 3. 验证
redis-cli ping

CentOS/RHEL

# 1. 安装 EPEL 仓库
sudo yum install epel-release -y

# 2. 安装 Redis
sudo yum install redis -y

# 3. 启动服务
sudo systemctl start redis
sudo systemctl enable redis

# 4. 验证
redis-cli ping

5.4 Redis 配置优化

编辑 /etc/redis/redis.conf:

# 绑定地址 (允许远程访问)
bind 0.0.0.0

# 设置密码 (生产环境必须)
requirepass YourRedisPassword123!

# 最大内存限制
maxmemory 2gb

# 内存淘汰策略
maxmemory-policy allkeys-lru

# 持久化配置
save 900 1
save 300 10
save 60 10000

# 日志级别
loglevel notice
logfile /var/log/redis/redis-server.log

重启 Redis 使配置生效:

sudo systemctl restart redis

---

🟢 六、Node.js 16+ 安装与配置

6.1 Windows 系统安装

步骤 1: 下载安装

1. 访问：https://nodejs.org/
2. 下载 LTS 版本 (长期支持版)
3. 运行安装包，按照向导完成安装

步骤 2: 验证

C:\> node -v
v18.18.0

C:\> npm -v
v10.2.0

6.2 macOS 系统安装

方式 1: Homebrew 安装

# 安装 Node.js
brew install node@18

# 验证
node -v
npm -v

方式 2: 官网下载

1. 访问：https://nodejs.org/
2. 下载 macOS pkg 安装包
3. 双击安装

6.3 Linux 系统安装

Ubuntu/Debian

# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证
node -v
npm -v

CentOS/RHEL

# 安装 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -

# 安装 Node.js
sudo yum install -y nodejs

# 验证
node -v
npm -v

6.4 配置 npm 镜像

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry

# 全局安装常用工具
npm install -g yarn
npm install -g pnpm
npm install -g @vue/cli

---

💻 七、IDE 开发工具配置

7.1 IDEA 安装与配置

步骤 1: 下载安装

1. 访问：https://www.jetbrains.com/idea/download/
2. 下载 Ultimate 版本 (推荐) 或 Community 版本
3. 安装后启动

步骤 2: 安装必要插件

File → Settings → Plugins → Marketplace

推荐安装插件:
✅ Lombok
✅ MyBatisX
✅ Alibaba Cloud Toolkit
✅ GitToolBox
✅ Rainbow Brackets
✅ Translation
✅ Key Promoter X

步骤 3: 配置 JDK 和 Maven

File → Project Structure → SDKs
1. 添加 JDK 17

File → Settings → Build, Execution, Deployment → Build Tools → Maven
1. Maven home directory: 选择 Maven 安装路径
2. User settings file: 选择 settings.xml
3. Local repository: 本地仓库路径

步骤 4: 导入项目

File → Open → 选择项目根目录 pom.xml
→ 选择 Trust Project
→ 等待 Maven 依赖下载完成

7.2 VSCode 安装与配置

步骤 1: 下载安装

1. 访问：https://code.visualstudio.com/
2. 下载并安装

步骤 2: 安装前端插件

Ctrl + Shift + X 打开扩展面板

推荐安装:
✅ Vetur (Vue 2 支持)
✅ Vue Language Features (Volar) (Vue 3 支持)
✅ ESLint
✅ Prettier
✅ Auto Close Tag
✅ Auto Rename Tag
✅ Path Intellisense
✅ Chinese (Simplified) Language Pack

步骤 3: 配置 settings.json

{
  "editor.fontSize": 14,
  "editor.tabSize": 2,
  "files.encoding": "utf8",
  "vetur.validation.template": false,
  "eslint.validate": [
    "javascript",
    "javascriptreact",
    "vue",
    "vue-html"
  ],
  "editor.formatOnSave": true
}

---

❓ 八、常见问题与解决方案

8.1 JDK 相关问题

问题 1: 提示"JAVA_HOME 未设置"

解决方案:

# Windows: 重新配置环境变量
# Mac/Linux: 编辑~/.zshrc 或~/.bash_profile
export JAVA_HOME=/path/to/jdk-17
source ~/.zshrc

问题 2: 多个 JDK 版本冲突

解决方案:

# Mac/Linux 使用 update-alternatives
sudo update-alternatives --config java

# Windows 修改 Path 环境变量顺序

8.2 Maven 相关问题

问题 1: 依赖下载速度慢

解决方案:

• 配置阿里云镜像 (见前文)
• 检查网络连接
• 清理本地仓库重试

问题 2: 编译报错"不支持的语言级别"

解决方案:

<!-- pom.xml 中配置 -->
<properties>
  <java.version>17</java.version>
  <maven.compiler.source>17</maven.compiler.source>
  <maven.compiler.target>17</maven.compiler.target>
</properties>

8.3 MySQL 相关问题

问题 1: 无法登录 (Access denied)

解决方案:

# 重置 root 密码
# 1. 停止 MySQL 服务
# 2. 跳过授权表启动
mysqld --skip-grant-tables
# 3. 无密码登录并修改密码
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';

问题 2: 中文乱码

解决方案:

-- 查看字符集
SHOW
VARIABLES LIKE '%character%';

-- 修改配置文件 my.cnf/my.ini
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci

[client]
default-character-set=utf8mb4

8.4 Redis 相关问题

问题 1: 连接被拒绝

解决方案:

# 检查 Redis 是否运行
redis-cli ping

# 检查 bind 配置
# redis.conf 中设置 bind 0.0.0.0

# 检查防火墙
sudo ufw allow 6379/tcp

问题 2: 内存不足

解决方案:

# redis.conf 配置
maxmemory 2gb
maxmemory-policy allkeys-lru

8.5 Node.js 相关问题

问题 1: npm install 权限错误

解决方案:

# 使用 nvm 管理 Node.js 版本
# 或使用 sudo(不推荐)
sudo npm install -g <package>

# 或修改 npm 默认目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

问题 2: Electron 安装失败

解决方案:

# 使用淘宝镜像
npm config set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
npm install

---

✅ 九、环境验证清单

完成所有安装后，请使用以下清单验证:

# ✅ Java 环境
java -version                    # 应显示 17.x.x
javac -version                   # 应显示 17.x.x
echo $JAVA_HOME                  # 应显示 JDK 路径

# ✅ Maven 环境
mvn -version                     # 应显示 3.9.x

# ✅ MySQL 环境
mysql --version                  # 应显示 8.2.0
mysql -u root -p                 # 能成功登录

# ✅ Redis 环境
redis-cli ping                   # 应返回 PONG
redis-cli info                   # 应显示 Redis 信息

# ✅ Node.js 环境
node -v                          # 应显示 v18.x.x
npm -v                           # 应显示 10.x.x

# ✅ 网络连通性
ping localhost                   # 测试本地网络
telnet localhost 3306           # 测试 MySQL 端口
telnet localhost 6379           # 测试 Redis 端口

---

⚠️ 避坑指南：5 个常见安装错误及解决方案

⚠️ 坑点 1: JAVA_HOME 配置错误导致 Maven 无法识别

现象:

# ❌ 错误现象
mvn -version
# 报错:
The JAVA_HOME environment variable is not defined correctly

# 或者
java -version  # 正常
mvn -version   # 报错

原因:

• JAVA_HOME 路径配置错误
• 路径包含空格或中文
• Maven 找不到 JDK

解决方案:

# ✅ Windows 正确配置
# 系统变量:
JAVA_HOME = C:\Program Files\Java\jdk-17
Path = %JAVA_HOME%\bin

# ✅ Mac/Linux 正确配置
# ~/.bash_profile 或 ~/.zshrc
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH

# 验证
echo $JAVA_HOME  # 应显示完整路径
java -version    # 显示 17.x.x
mvn -version     # 正常显示

---

⚠️ 坑点 2: MySQL 8.2 初始化失败

现象:

# ❌ 错误现象
mysqld --initialize-insecure
# 报错:
[ERROR] Data Directory initialization failed

# 或者
mysql: unknown option '--default-authentication-plugin=mysql_native_password'

原因:

• data 目录已存在且有数据
• 权限不足
• 配置文件冲突

解决方案:

# ✅ Windows 正确做法
# 1. 删除 data 目录 (如果有)
rd /s /q "C:\Program Files\MySQL\MySQL Server 8.2\data"

# 2. 以管理员身份运行 CMD
cd "C:\Program Files\MySQL\MySQL Server 8.2\bin"
mysqld --initialize-insecure --console

# ✅ Mac/Linux 正确做法
# 1. 删除旧数据
sudo rm -rf /usr/local/mysql/data

# 2. 重新初始化
mysqld --initialize-insecure --user=mysql

# 3. 启动 MySQL
sudo systemctl start mysqld

# 4. 首次登录 (无密码)
mysql -u root -p  # 直接回车

---

⚠️ 坑点 3: Redis 启动失败 (Windows)

现象:

# ❌ 错误现象
redis-server redis.windows.conf
# 报错:
Creating Server TCP listening socket 127.0.0.1:6379: bind: No error

# 或者闪退

原因:

• 端口 6379 被占用
• 配置文件路径错误
• Windows 防火墙阻止

解决方案:

# ✅ 正确做法
# 1. 检查端口占用
netstat -ano | findstr :6379
# 如果有进程，杀掉进程
taskkill /PID <PID> /F

# 2. 修改配置文件
# redis.windows.conf
bind 127.0.0.1
port 6379
protected-mode no

# 3. 以服务方式安装 (推荐)
redis-server --service-install redis.windows.conf
redis-server --service-start

# 4. 验证
redis-cli ping  # 应返回 PONG

---

⚠️ 坑点 4: Maven 下载依赖速度极慢

现象:

# ❌ 错误现象
mvn clean install
# 下载速度 < 10KB/s
# 经常超时失败
[WARNING] Could not transfer metadata

原因:

• 使用 Maven 中央仓库 (在国外)
• 网络连接不稳定
• 没有配置镜像

解决方案:

<!-- ✅ 配置阿里云镜像 -->
<!-- 编辑 ~/.m2/settings.xml -->
<settings>
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

  <!-- 配置国内镜像源 -->
  <profiles>
    <profile>
      <id>aliyun</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>https://maven.aliyun.com/repository/public</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
</settings>

  <!-- 速度对比 -->
  <!-- 优化前：下载所有依赖需要 30 分钟 -->
  <!-- 优化后：下载所有依赖仅需 3-5 分钟 -->
  <!-- 提升：80-90% ↓ -->

---

⚠️ 坑点 5: Node.js npm install 失败

现象:

# ❌ 错误现象
npm install
# 报错:
npm ERR! code ECONNRESET
npm ERR! errno ECONNRESET
npm ERR! network request failed

# 或者卡在某个包不动
[..................] | fetchMetadata: sill fetch package manifest

原因:

• 使用国外 npm 源
• Electron 等包下载失败
• 网络不稳定

解决方案:

# ✅ 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry  # 应显示 https://registry.npmmirror.com

# ✅ 针对 Electron 特殊处理
npm config set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

# ✅ 清理缓存重试
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

# ✅ 使用 nrm 管理镜像源
npm install -g nrm
nrm use taobao

# 速度对比:
# 优化前：npm install 需要 20 分钟
# 优化后：npm install 仅需 2-3 分钟
# 提升：85-90% ↓

---

📊 性能优化建议

6.1 Maven 构建优化

优化前:

<!-- ❌ 默认配置，速度慢 -->
<settings>
  <!-- 没有镜像配置 -->
</settings>

优化后:

<!-- ✅ 阿里云镜像 + 并行构建 -->
<!-- ~/.m2/settings.xml -->
<settings>
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

  <!-- 并行构建配置 -->
  <profiles>
    <profile>
      <id>parallel</id>
      <properties>
        <maven.compiler.parallel>true</maven.compiler.parallel>
      </properties>
    </profile>
  </profiles>
</settings>

  # 使用并行构建
  mvn clean install -T 1C  # 每个 CPU 核心一个线程

性能对比:

指标	优化前	优化后	提升幅度
首次构建时间	30 分钟	5 分钟	-83% ↓
增量构建时间	10 分钟	2 分钟	-80% ↓
依赖下载速度	10KB/s	5MB/s	+50000% ↑

---

6.2 MySQL 查询优化

优化前:

-- ❌ 默认配置，查询慢
SELECT *
FROM sys_user
WHERE dept_id = 1;
-- 全表扫描，耗时 2 秒

优化后:

-- ✅ 添加索引
CREATE INDEX idx_dept_id ON sys_user (dept_id);

-- ✅ 优化查询
SELECT user_id, username, email
FROM sys_user
WHERE dept_id = 1;
-- 使用索引，耗时 0.05 秒

-- ✅ 查看执行计划
EXPLAIN
SELECT user_id, username
FROM sys_user
WHERE dept_id = 1;
-- type: ref (使用索引)
-- key: idx_dept_id

性能对比:

指标	优化前	优化后	提升幅度
查询时间	2 秒	0.05 秒	-97.5% ↓
扫描行数	10000 行	10 行	-99.9% ↓
索引使用	全表扫描	索引查询	质变

---

6.3 Redis 缓存优化

优化前:

# ❌ 默认配置
# redis.conf
maxmemory 256mb
maxmemory-policy noeviction

优化后:

# ✅ 生产配置
# redis.conf
maxmemory 2gb                          # 根据内存调整
maxmemory-policy allkeys-lru           # LRU 淘汰策略

  # 持久化优化
appendonly yes                         # 开启 AOF
appendfsync everysec                   # 每秒同步

  # 性能优化
tcp-keepalive 60                       # 保持连接
timeout 300                            # 超时断开

性能对比:

指标	优化前	优化后	提升幅度
内存利用率	256MB	2GB	+680% ↑
查询延迟	5ms	0.5ms	-90% ↓
并发能力	1000 QPS	10000 QPS	+900% ↑

---

📝 总结

本文系统介绍了飞鱼管理系统开发环境的完整搭建流程，包括5 个常见安装错误解决方案和3 套性能优化方案。关键收获:

1. 环境搭建要规范: JDK、Maven、MySQL、Redis 每个软件都要正确配置环境变量和参数
2. 避坑指南至关重要: 提前了解常见错误和解决方案，避免踩坑浪费时间
3. 性能优化不可忽视: Maven 镜像配置提升 80% 构建速度、MySQL 索引优化提升 97% 查询速度、Redis 配置优化提升 900% 并发能力

环境搭建建议:

• ✅ 严格按照步骤操作，不要跳过任何配置
• ✅ 使用国内镜像源加速下载 (阿里云 Maven、淘宝 npm)
• ✅ 安装完成后立即验证，确保所有服务正常
• ✅ 保存好安装配置文档，便于后续查阅

下一篇文章,我们将深入剖析飞鱼系统的源码结构，带你理解多模块项目的组织架构和设计原理，敬请期待!

---

👍 如果本文对你有帮助，欢迎点赞、收藏、转发!
💬 有任何问题或建议，请在评论区留言交流~
🔔 关注我，获取飞鱼系统 Spring Boot 3.x 系列文章!
📝 行文仓促，定有不足之处，欢迎各位朋友在评论区批评指正，不胜感激!!

专栏导航:

• 上一篇:飞鱼系统技术栈全景解析
• 下一篇:飞鱼系统源码结构深度剖析 - 待更新