一. macOS 系统
第一步:确认当前 Shell 类型
打开"终端"(可通过 Command + Space 搜索 Terminal),输入以下命令并回车:
echo $SHELL
- 如果输出
/bin/zsh(macOS Catalina 及之后默认),请编辑~/.zshrc文件。 - 如果输出
/bin/bash,请编辑~/.bash_profile文件。
第二步:选择配置方式
适用于日常开发需求,修改当前用户的 Shell 配置文件。
-
打开配置文件(以 zsh 为例,若文件不存在会自动创建):
nano ~/.zshrc
-
在文件末尾添加环境变量(例如配置 Java 或 Python 路径):
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home
export PATH=JAVA_HOME/bin:PATH -
保存并退出:按
Control + O保存,按回车确认,然后按Control + X退出 -
使配置立即生效:bash
source ~/.zshrc
第三步:验证配置是否生效
在终端中执行以下命令,检查输出中是否包含你添加的路径或变量值:
1echo $PATH
2echo $JAVA_HOME
二.Windows 系统环境变量配置
在 Windows 中,环境变量分为用户变量 (仅对当前用户生效)和系统变量(对所有用户生效,需管理员权限)。
1. 图形界面配置(最推荐,直观安全)
- 快捷进入 :按下
Win + R键,输入rundll32 sysdm.cpl,EditEnvironmentVariables并回车,可直接打开环境变量设置窗口。 - 常规路径:右键点击"此电脑" -> 选择"属性" -> 点击"高级系统设置" -> 在"高级"选项卡下点击"环境变量"。
- 操作 :在"用户变量"或"系统变量"区域,点击"新建"添加变量,或选中
Path变量点击"编辑"来追加新的路径。
2. 命令行配置
-
临时生效(仅当前会话) :使用
set命令。关闭窗口后失效,适合快速测试。set MY_VAR=HelloWorld
set PATH=%PATH%;C:\MyTools -
永久生效(使用 setx 命令):
-
-
设置用户级变量:
setx MY_VAR "HelloWorld" -
设置系统级变量(需管理员权限):
setx /M JAVA_HOME "C:\Program Files\Java\jdk-21" -
⚠️ 警告 :不推荐直接使用
setx PATH "%PATH%;新路径"来追加 PATH,因为%PATH%会展开为当前合并后的值,容易导致系统 PATH 内容被重复写入用户 PATH 中,造成臃肿。推荐使用 PowerShell 安全追加:[Environment]::SetEnvironmentVariable("Path", $env:Path + ";D:\Tools\MyApp", "User")
-
2.验证配置
Windows :打开新的 CMD 窗口,输入 echo %MY_VAR% 或 echo %PATH%。
三. Linux 系统环境变量配置
Linux 的配置方式更加灵活,通常通过修改 Shell 配置文件来实现。
1. 临时设置(仅当前终端有效)
在终端中直接使用 export 命令,关闭窗口后失效。
export MY_VAR="production"
export PATH="/opt/myapp/bin:$PATH"
注意:配置 PATH 时务必加上 PATH**(如* *PATH:/new/path*),否则会覆盖系统原有的路径。*
2. 用户级永久配置(推荐常用方式)
修改当前用户的 Shell 初始化文件,仅对当前登录用户生效。
-
首先确认当前 Shell 类型:
echo $SHELL。 -
若为
bash,编辑~/.bashrc;若为zsh,编辑~/.zshrc。nano ~/.bashrc
-
在文件末尾添加:
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=JAVA_HOME/bin:PATH -
保存退出后,执行
source ~/.bashrc使配置立即生效。
3. 系统级全局配置(对所有用户生效)
需要管理员(root)权限,适用于多用户共享工具或全局路径配置。
-
方法一(模块化推荐) :在
/etc/profile.d/目录下创建独立的.sh脚本文件,便于管理和卸载。sudo nano /etc/profile.d/myapp.sh
写入内容:export PATH="/opt/myapp/bin:$PATH"
sudo chmod +x /etc/profile.d/myapp.sh
-
方法二(传统全局文件) :编辑
/etc/profile或/etc/bashrc,在末尾添加export语句。 -
方法三(纯文本赋值) :编辑
/etc/environment。注意该文件不支持$PATH变量展开,必须写完整的绝对路径列表,且不需要使用export命令。 -
修改全局配置后,通常需要重新登录或重启系统才能生效。
4.验证配置
- Linux :在终端输入
echo $MY_VAR或echo $PATH。