核心观点：环境变量是操作系统为应用程序提供的“全局配置字典”，它让软件能够在不同环境中灵活运行，而无需修改代码。配置环境变量的本质，是告诉操作系统和应用程序“去哪里找需要的资源”。
一、环境变量是什么？
1.1 一个生活类比
| 场景 | 现实世界 | 计算机世界 |
|---|
| 你到了一个新城市 | 你需要知道“市政府在哪”、“医院在哪”、“学校在哪” | 程序需要知道“Java安装在哪”、“Maven仓库在哪”、“数据库在哪” |
| 获取信息的方式 | 通过城市地图、路标、问路 | 通过环境变量（如JAVA_HOME、PATH） |
| 默认约定 | 市政府通常在市中心，但没有标准位置 | 环境变量告诉程序“没有默认位置时的标准路径” |
环境变量就是计算机的“城市地图”——程序启动时，先查地图（环境变量），才知道去哪里找它需要的东西。
1.2 技术定义
| 维度 | 说明 |
|---|
| 本质 | 操作系统维护的一组键值对（Key-Value） |
| 存储位置 | 操作系统内核维护的进程环境块（Process Environment Block） |
| 生命周期 | 系统级（永久）、用户级（永久）、会话级（临时） |
| 访问方式 | Windows：%VAR_NAME%；Linux/macOS：$VAR_NAME |
| 作用域 | 当前进程及其子进程继承 |
二、环境变量的类型与作用域
2.1 三种作用域
| 类型 | 作用范围 | 生命周期 | 典型用途 | 修改方式 |
|---|
| 系统环境变量 | 所有用户、所有进程 | 永久（直到手动修改） | JAVA_HOME、PATH系统级路径 | 系统属性 → 高级 → 环境变量 → 系统变量 |
| 用户环境变量 | 当前用户的所有进程 | 永久（直到手动修改） | 用户自定义的MAVEN_HOME、GRADLE_HOME | 系统属性 → 高级 → 环境变量 → 用户变量 |
| 会话环境变量 | 当前命令行窗口 | 临时（窗口关闭即失效） | 临时覆盖某个路径用于测试 | set VAR=value（Windows）或export VAR=value（Linux/macOS） |
2.2 环境变量的优先级
text
会话级变量（最高优先级） ↓ 覆盖 用户级变量 ↓ 覆盖 系统级变量（最低优先级）
优先级规则：当同名变量存在时，会话级覆盖用户级，用户级覆盖系统级。
三、常见的环境变量详解
3.1 Java 相关环境变量
| 变量名 | 含义 | 典型值（Windows） | 作用 | 缺失后果 |
|---|
JAVA_HOME | Java 安装根目录 | C:\Program Files\Java\jdk-17 | 告诉系统和工具“Java 安装在哪里” | 很多 Java 工具（Maven、Tomcat）无法找到 JDK |
PATH（追加 Java） | 系统可执行文件搜索路径 | %JAVA_HOME%\bin | 让系统在任意目录下都能执行java和javac命令 | 命令行输入java会报“不是内部或外部命令” |
CLASSPATH | Java 类库搜索路径 | .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar | 告诉 JVM 去哪里找 .class 文件和库 | 现代 Java（1.5+）极少需要配置，默认会从当前目录和 jar 包中加载 |
3.2 Maven 相关环境变量
| 变量名 | 含义 | 典型值（Windows） | 作用 | 缺失后果 |
|---|
MAVEN_HOME | Maven 安装根目录 | D:\apache-maven-3.9.6 | 告诉工具“Maven 安装在哪里” | Maven 无法正常运行 |
PATH（追加 Maven） | 系统可执行文件搜索路径 | %MAVEN_HOME%\bin | 让系统在任意目录下都能执行mvn命令 | 命令行输入mvn会报“不是内部或外部命令” |
M2_HOME | 旧版 Maven 变量（已废弃） | — | 已被MAVEN_HOME取代 | 无需配置 |
3.3 MySQL 相关环境变量
| 变量名 | 含义 | 典型值（Windows） | 作用 | 缺失后果 |
|---|
MYSQL_HOME | MySQL 安装根目录 | C:\Program Files\MySQL\MySQL Server 8.0 | 告诉工具“MySQL 安装在哪里” | MySQL 客户端工具可能无法找到配置文件 |
PATH（追加 MySQL） | 系统可执行文件搜索路径 | %MYSQL_HOME%\bin | 让系统在任意目录下都能执行mysql命令 | 命令行输入mysql会报“不是内部或外部命令” |
3.4 其他常用环境变量
| 变量名 | 含义 | 典型值 | 作用 |
|---|
GRADLE_HOME | Gradle 安装根目录 | C:\gradle-8.5 | 让 Gradle 工具找到自己的安装位置 |
NODE_HOME | Node.js 安装根目录 | C:\Program Files\nodejs | 让 Node.js 工具找到自己的安装位置 |
ANDROID_HOME | Android SDK 安装目录 | C:\Users\Lenovo\AppData\Local\Android\Sdk | Android 开发工具查找 SDK |
PATH（追加） | 通用可执行文件搜索路径 | %ANDROID_HOME%\platform-tools | 在任意目录下执行adb等命令 |
TEMP/TMP | 临时文件目录 | C:\Users\Lenovo\AppData\Local\Temp | 应用程序存放临时文件 |
HOME/USERPROFILE | 用户主目录 | C:\Users\Lenovo | 应用程序存储用户配置 |
四、为什么需要配置环境变量？
4.1 从“硬编码”到“配置化”的演进
| 阶段 | 方式 | 问题 | 如何解决 |
|---|
| 硬编码阶段 | 软件直接写死路径，如C:\Program Files\Java\jdk1.8.0_301\bin\java.exe | 换个版本或换台电脑就要改代码 | 使用环境变量抽象路径 |
| 环境变量阶段 | 软件通过JAVA_HOME查找路径 | 只需要配置一次，所有工具共享 | 一次配置，随处使用 |
| 容器化阶段 | 通过 Docker 的-e参数传入环境变量 | 不同容器可以有不同的配置 | 配置与镜像分离 |
4.2 配置环境变量的核心作用
| 作用 | 说明 | 实际例子 |
|---|
| 路径抽象 | 将具体路径抽象为变量名，方便切换版本 | 从 JDK 8 换到 JDK 17，只需改JAVA_HOME，所有工具自动生效 |
| 跨平台兼容 | 不同操作系统路径格式不同，用变量统一 | Windows:%JAVA_HOME%\bin，Linux:$JAVA_HOME/bin |
| 工具共享 | 多个工具共享同一个环境变量 | Maven、Tomcat、Gradle 都通过JAVA_HOME找到 JDK |
| 配置外部化 | 配置与代码分离，无需修改代码即可调整 | 修改JAVA_HOME就能切换 JDK 版本 |
| 安全隔离 | 敏感信息（如密码）不写在代码中 | 数据库密码通过环境变量传入，不暴露在代码仓库 |
五、Windows 环境变量配置详解
5.1 配置步骤
| 步骤 | 操作 | 说明 |
|---|
| 1 | 右键“此电脑” → 属性 | 打开系统属性 |
| 2 | 高级系统设置 → 环境变量 | 进入环境变量编辑界面 |
| 3 | 点击“新建”（系统变量） | 创建JAVA_HOME |
| 4 | 变量名：JAVA_HOME
变量值：C:\Program Files\Java\jdk-17 | 指向 JDK 安装根目录 |
| 5 | 在PATH中添加%JAVA_HOME%\bin | 让系统能找到java命令 |
| 6 | 点击“确定”保存 | — |
| 7 | 重新打开命令行 | 使配置生效 |
5.2 Windows 中PATH变量详解
text
%JAVA_HOME%\bin;%MAVEN_HOME%\bin;%MYSQL_HOME%\bin;C:\Windows\System32;...
PATH的工作原理：当你在命令行输入java时，操作系统会从左到右依次在PATH中列出的目录里查找java.exe，找到第一个就执行。
5.3 验证环境变量配置
cmd
# 查看所有环境变量 set # 查看特定变量 echo %JAVA_HOME% echo %PATH% # 验证 Java java -version javac -version # 验证 Maven mvn -version # 验证 MySQL mysql --version
六、Linux/macOS 环境变量配置详解
6.1 配置文件差异
| 配置文件 | 作用范围 | 加载时机 | 适用场景 |
|---|
/etc/profile | 所有用户 | 系统启动时 | 系统级配置 |
~/.bash_profile | 当前用户（登录 Shell） | 用户登录时 | 用户级配置（macOS 默认） |
~/.bashrc | 当前用户（交互式 Shell） | 每次打开终端时 | 用户级配置（Linux 默认） |
~/.zshrc | 当前用户（Zsh） | 每次打开终端时 | 使用 Zsh 的用户 |
/etc/environment | 所有用户（Ubuntu） | 系统启动时 | 系统级环境变量 |
6.2 配置示例（~/.bashrc或~/.zshrc）
bash
# Java export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH # Maven export MAVEN_HOME=/usr/local/apache-maven-3.9.6 export PATH=$MAVEN_HOME/bin:$PATH # MySQL export MYSQL_HOME=/usr/local/mysql export PATH=$MYSQL_HOME/bin:$PATH # 使配置生效 source ~/.bashrc # 或 source ~/.zshrc
6.3 Linux/macOS 中PATH的工作原理
注意顺序：export PATH=$JAVA_HOME/bin:$PATH将$JAVA_HOME/bin放在PATH最前面，这样系统会优先使用 Java 的java命令，而不是系统自带的旧版本。
七、配置文件中的环境变量（Spring Boot）
在 Spring Boot 项目中，环境变量可以覆盖application.yml中的配置：
| 环境变量名 | application.yml 配置 | 说明 |
|---|
SPRING_DATASOURCE_URL | spring.datasource.url | 数据库连接 URL |
SPRING_DATASOURCE_USERNAME | spring.datasource.username | 数据库用户名 |
SPRING_DATASOURCE_PASSWORD | spring.datasource.password | 数据库密码 |
SERVER_PORT | server.port | 服务端口 |
SPRING_PROFILES_ACTIVE | spring.profiles.active | 激活的配置文件 |
bash
# 通过环境变量启动 Spring Boot export SPRING_DATASOURCE_URL=jdbc:mysql://prod-db:3306/mydb export SPRING_DATASOURCE_USERNAME=prod_user export SPRING_DATASOURCE_PASSWORD=prod_password java -jar myapp.jar
八、常见问题与排查
| 问题 | 可能原因 | 解决方法 |
|---|
'java' 不是内部或外部命令 | PATH中没有%JAVA_HOME%\bin | 检查JAVA_HOME和PATH配置 |
JAVA_HOME指向 JRE 而非 JDK | JAVA_HOME路径配置错误 | 将JAVA_HOME指向 JDK 根目录，而不是 JRE |
| 修改环境变量后不生效 | 命令行未重启 | 关闭并重新打开命令行 |
| 多个 Java 版本冲突 | PATH中多个 Java 路径 | 调整PATH顺序，将期望的版本放在前面 |
| Maven 找不到 JDK | JAVA_HOME未配置 | 确保JAVA_HOME正确配置 |
| IDEA 中 Maven 报错 | IDEA 未使用系统JAVA_HOME | File → Settings → Build, Execution, Deployment → Build Tools → Maven → Runner → JRE |
九、总结
| 维度 | 核心结论 |
|---|
| 本质 | 环境变量是操作系统维护的键值对，为应用程序提供运行时的配置信息 |
| 作用 | 路径抽象、跨平台兼容、工具共享、配置外部化、安全隔离 |
| 类型 | 系统变量、用户变量、会话变量（优先级从低到高） |
| 关键变量 | JAVA_HOME、MAVEN_HOME、PATH、CLASSPATH |
| 配置原则 | 一次配置，多处共享；路径用变量，避免硬编码 |
| 验证方法 | echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（Linux/macOS） |
| 生效条件 | 修改后需要重新打开命令行或重新加载配置文件 |
一句话总结：环境变量是软件的“地图”——它告诉程序“去哪里找需要的东西”。配置环境变量，就是为软件指明方向，让它们能在不同的环境中灵活、正确地运行。没有环境变量，软件只能硬编码路径，换台电脑就要重新编译；有了环境变量，软件一次编译，处处运行。
