第3章环境准备

第3章：环境准备——JDK、Maven、Git、Docker 搭建与验证

说实话，很多同学学分布式配置中心，上来就写代码，结果环境配了一整天还没跑起来。我见过太多次了。所以这一章，咱们老老实实把地基打牢。

我会带你装好四样东西：JDK、Maven、Git、Docker。每装一个，我都会告诉你验证方法。嗯，跟着我来，半小时搞定。

3.1 JDK：一切 Java 应用的基石

分布式配置中心大多基于 Java 开发，比如 Apollo、Nacos。所以 JDK 是必须的。我个人习惯用 JDK 8 或 JDK 11，这两个版本最稳。

3.1.1 安装步骤

去 Oracle 官网或 Adoptium 下载 JDK 8（推荐 8u202 以上版本）
双击安装，记住安装路径，比如 C:\Program Files\Java\jdk1.8.0_202
配置环境变量：
- JAVA_HOME = 你的安装路径
- PATH 里追加 %JAVA_HOME%\bin

小技巧： 我习惯把 JAVA_HOME 配好后，再配一个 CLASSPATH，值为 .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar。虽然现在很多工具不强制要求了，但老项目可能还需要。

3.1.2 验证方法

打开命令行，输入：

java -version
javac -version

如果看到类似这样的输出，就说明成了：

java version "1.8.0_202"
Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)

注意： 我曾经遇到过一个问题——明明装了 JDK，但 javac 提示找不到。后来发现是 PATH 里只配了 JAVA_HOME，忘了加 \bin。你想想看，这种低级错误排查起来还挺费时间的。

3.2 Maven：项目构建与依赖管理

Maven 是 Java 生态里最常用的构建工具。配置中心项目通常用 Maven 管理依赖，所以必须装。

3.2.1 安装步骤

去 Maven 官网下载二进制包（apache-maven-3.8.x-bin.zip）
解压到某个目录，比如 D:\tools\apache-maven-3.8.6
配置环境变量：
- MAVEN_HOME = 解压路径
- PATH 里追加 %MAVEN_HOME%\bin

3.2.2 配置阿里云镜像（加速下载）

Maven 默认从中央仓库下载，速度慢得让人抓狂。我建议你改一下 settings.xml：

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

避坑指南： 我曾经帮一个同事排查问题，他每次构建都卡在下载依赖上。结果发现 settings.xml 里配了两个镜像，冲突了。记住，mirrorOf 用 central 就行，别画蛇添足。

3.2.3 验证方法

mvn -version

输出应该包含 Maven 版本、Java 版本和操作系统信息：

Apache Maven 3.8.6 (84538c9988a25aec085021c365c560670ad80f63)
Maven home: D:\tools\apache-maven-3.8.6
Java version: 1.8.0_202, vendor: Oracle Corporation

3.3 Git：版本控制与代码管理

配置中心的配置变更需要版本管理，Git 是标配。而且很多配置中心项目都托管在 GitHub 上，你得能 clone 下来。

3.3.1 安装步骤

去 Git 官网下载安装包（Git-2.x.x-64-bit.exe）
一路 Next，注意在「选择默认编辑器」那一步，我建议选 VSCode 或 Notepad++
安装完成后，配置全局用户名和邮箱：

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

3.3.2 验证方法

git --version

输出类似：

git version 2.39.0.windows.1

再验证一下配置是否生效：

git config --list

注意： 如果你在 Windows 上遇到 warning: LF will be replaced by CRLF，别慌。这是换行符差异导致的。我建议执行 git config --global core.autocrlf true，让 Git 自动处理。

3.4 Docker：容器化部署利器

分布式配置中心通常以 Docker 容器方式部署。比如 Nacos 官方就提供了 Docker 镜像。所以 Docker 是必装的。

3.4.1 安装步骤

Windows 用户推荐安装 Docker Desktop。去 Docker 官网下载安装包，双击安装即可。安装完成后，可能需要重启电脑。

Linux 用户（以 Ubuntu 为例）：

sudo apt update
sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

3.4.2 验证方法

docker --version
docker run hello-world

如果看到 Hello from Docker! 的提示，说明 Docker 运行正常。

个人经验： 我第一次用 Docker Desktop 时，启动后一直报 WSL 相关的错误。后来发现是 Windows 的 WSL2 没装好。解决办法是去 PowerShell 执行 wsl --install，然后重启。嗯，这个坑我踩过，你注意一下。

3.5 环境验证总表

为了方便你快速检查，我整理了一个验证清单：

工具	验证命令	预期输出
JDK	`java -version`	显示 Java 版本号（如 1.8.0_202）
Maven	`mvn -version`	显示 Maven 和 Java 版本
Git	`git --version`	显示 Git 版本号
Docker	`docker --version`	显示 Docker 版本号

核心要点： 环境搭建看似简单，但细节决定成败。我建议你每装一个工具，都立刻验证。别等到写代码时才发现环境有问题，那时候排查起来更痛苦。

3.6 常见问题与避坑指南

问题1： 命令行找不到 java 命令。→ 检查 PATH 环境变量是否包含 %JAVA_HOME%\bin
问题2： Maven 下载依赖超时。→ 配置阿里云镜像，或者检查网络代理设置
问题3： Git 提交时提示 Please tell me who you are。→ 执行 git config --global user.name 和 user.email
问题4： Docker Desktop 启动失败。→ 检查 BIOS 是否开启了虚拟化（VT-x/AMD-V）

📚 课程目录