第3章开发环境搭建

3、开发环境搭建：JDK与Maven/Gradle安装配置、IDE设置、Git初始化、Docker容器化环境、数据库客户端工具

说实话，很多新手一上来就急着写代码，结果环境没配好，折腾半天连个Hello World都跑不起来。我见过太多这样的案例了。这一章，咱们就把开发环境彻底搞定。你跟着我的节奏来，保证一次过。

3.1 JDK安装与配置——Java的根基

ERP系统几乎都是用Java写的，所以JDK是第一步。我个人习惯用JDK 11或17，这两个版本都是长期支持版，稳定。

下载与安装

去Oracle官网或Adoptium下载JDK。我推荐Adoptium，开源免费，省心。
安装路径不要带中文和空格。比如：C:\Java\jdk-17

配置环境变量

这一步很多人会漏掉。你需要配两个东西：

JAVA_HOME：指向JDK安装目录
Path：加上 %JAVA_HOME%\bin

配完之后，打开命令行输入：

java -version
javac -version

能看到版本号，就说明成了。

⚠️ 我曾经遇到过一个问题：明明配了环境变量，但命令行还是提示找不到Java。后来发现是Path里多了个空格。嗯，这里要注意，路径里不要有多余的空格或分号。

3.2 Maven与Gradle——构建工具的选择

说白了，构建工具就是帮你管理依赖、打包、编译的。ERP项目依赖的jar包特别多，手动管理会疯掉。

Maven

我个人更常用Maven，因为它的pom.xml结构清晰，社区生态也成熟。

下载Maven，解压到 C:\Maven
配置 MAVEN_HOME 和 Path
修改 conf/settings.xml，加上阿里云镜像，不然下载依赖慢得你想哭

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

Gradle

如果你喜欢简洁的配置，Gradle是个好选择。它用Groovy或Kotlin DSL，比Maven的XML更灵活。我在一个微服务项目里用过Gradle，构建速度确实快一些。

💡 我的建议：新手先用Maven，等熟悉了再尝试Gradle。别一开始就两个都学，容易乱。

3.3 IDE设置——IntelliJ IDEA vs Eclipse

IDE这东西，用顺手了就是神器。我个人强烈推荐IntelliJ IDEA，尤其是它的智能提示和重构功能，写ERP业务逻辑时特别爽。

IntelliJ IDEA设置要点

安装后先配JDK：File → Project Structure → SDK
安装插件：Lombok（ERP里常用）、MyBatisX（如果用了MyBatis）、Git Integration
调整内存：Help → Edit Custom VM Options，把 -Xmx 改成 2048m，不然项目大了会卡

Eclipse设置要点

如果你公司强制用Eclipse，也别慌。记得装个 Spring Tools Suite 插件，不然Spring项目跑不起来。

🔧 避坑指南：我曾经在Eclipse里导入一个Maven项目，结果报了一堆错。后来发现是Eclipse自带的Maven版本太旧。解决办法：在Eclipse里配置自己安装的Maven，别用内置的。

3.4 Git版本控制初始化——团队协作的基石

ERP项目通常多人协作，没有Git简直不敢想象。你想想看，如果两个人同时改了同一个文件，怎么合并？

初始化步骤

安装Git，配置用户名和邮箱：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

git init

创建 .gitignore 文件，忽略 target/、.idea/、*.iml 等文件

分支策略

我建议用 master/main 作为主分支，develop 作为开发分支，每个人再拉自己的功能分支。这样不会互相干扰。

⚠️ 注意：千万不要把 .idea 或 target 提交到仓库。我见过有人把整个IDEA配置都提交了，结果别人拉下来一堆冲突。

3.5 Docker容器化环境搭建——让环境一致

为什么需要Docker？说白了，就是为了解决「在我电脑上能跑，在你电脑上就跑不了」的问题。ERP系统依赖的中间件多，数据库、Redis、消息队列……用Docker一键搞定。

安装Docker

Windows用户装Docker Desktop，记得开启WSL2
Linux用户直接 sudo apt install docker.io

常用命令

# 拉取MySQL镜像
docker pull mysql:8.0

# 运行MySQL容器
docker run --name erp-mysql -e MYSQL_ROOT_PASSWORD=root -p 3306:3306 -d mysql:8.0

# 查看运行中的容器
docker ps

我在一个ERP项目里，用Docker Compose同时启动了MySQL、Redis和Nacos，一条命令全部搞定。你想想看，要是手动装这些，得花多少时间？

💡 小技巧：写一个 docker-compose.yml 文件，把数据库、缓存、消息队列都定义好。以后换电脑，直接 docker-compose up -d 就行。

3.6 数据库客户端工具——Navicat与DBeaver

ERP系统离不开数据库，你总得有个趁手的工具来查看数据、执行SQL吧？

Navicat

功能强大，界面漂亮。支持MySQL、Oracle、PostgreSQL等。但它是收费的。我个人觉得，如果公司报销，用Navicat很舒服。

DBeaver

免费开源，跨平台。我最近几年一直在用DBeaver，因为它支持几乎所有数据库，而且插件丰富。

连接配置要点

主机：如果是本地Docker容器，填 localhost 或 127.0.0.1
端口：MySQL默认3306，PostgreSQL默认5432
驱动：DBeaver会自动下载驱动，Navicat需要手动配置

🔧 我曾经踩过的坑：用Navicat连接Docker里的MySQL，死活连不上。后来发现是Docker容器没映射端口。记得在 docker run 时加上 -p 3306:3306。

3.7 环境验证——确保一切就绪

所有东西都装好了，怎么验证？我一般会写一个简单的Spring Boot项目，跑起来看看。

// 一个简单的Controller
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "ERP开发环境搭建成功！";
    }
}

启动项目，访问 http://localhost:8080/hello，看到返回信息，就说明环境没问题了。

💡 最后说一句：环境搭建是磨刀不误砍柴工。别嫌麻烦，一次性配好，后面能省你80%的调试时间。我每次接手新项目，第一件事就是检查环境，从不例外。

📚 课程目录

3、开发环境搭建：JDK与Maven/Gradle安装配置、IDE设置、Git初始化、Docker容器化环境、数据库客户端工具

3.1 JDK安装与配置——Java的根基

3.2 Maven与Gradle——构建工具的选择

3.3 IDE设置——IntelliJ IDEA vs Eclipse

3.4 Git版本控制初始化——团队协作的基石

3.5 Docker容器化环境搭建——让环境一致

3.6 数据库客户端工具——Navicat与DBeaver

3.7 环境验证——确保一切就绪