环境变量与 PATH

4 min入门2026/9/12

环境变量概念、PATH机制、跨平台配置与常见问题排查。

1. 环境变量基础

1.1 什么是环境变量

环境变量是操作系统中用于存储配置信息的键值对，进程运行时可以读取这些变量来获取配置。每个进程都从其父进程继承环境变量，形成了一条从系统启动到当前进程的环境变量链。

KEY=VALUE
HOME=/home/user
PATH=/usr/local/bin:/usr/bin:/bin
LANG=en_US.UTF-8

环境变量的核心作用：

配置传递：无需修改代码即可改变程序行为
路径声明：告诉系统去哪里查找可执行文件
密钥管理：存储 API Key 等敏感信息（不应硬编码）
行为控制：控制程序的调试模式、日志级别等

1.2 环境变量的分类

类型	作用域	示例	说明
系统级	所有用户	`PATH`、`SystemRoot`	系统启动时加载
用户级	当前用户	`HOME`、`USER`	用户登录时加载
进程级	当前进程	`NODE_ENV`、`PORT`	进程运行时设置
Shell 级	当前 Shell 会话	临时变量	会话结束后消失

1.3 环境变量的生命周期

系统启动 → 加载系统级变量
    ↓
用户登录 → 加载用户级变量（~/.bashrc, ~/.zshrc 等）
    ↓
Shell 会话 → 加载 Shell 配置
    ↓
进程启动 → 继承父进程环境变量
    ↓
进程运行 → 可读取/修改自身环境变量
    ↓
进程结束 → 进程级变量消失

2. PATH 机制详解

2.1 PATH 的工作原理

PATH 是最重要的环境变量，它定义了系统查找可执行文件的搜索路径列表。当你在终端输入一个命令时，Shell 会按顺序在 PATH 中的每个目录里查找对应的可执行文件。

# 查看 PATH
echo $PATH
# 输出: /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

# 查找命令的实际位置
which python3
# 输出: /usr/local/bin/python3

# 查找所有匹配的位置
where node    # Windows
which -a node # macOS/Linux

2.2 PATH 搜索流程

输入命令: python3
    ↓
检查是否为 Shell 内建命令？ → 是 → 执行内建命令
    ↓ 否
检查是否为别名（alias）？ → 是 → 展开别名
    ↓ 否
遍历 PATH 目录:
    /usr/local/bin/python3 → 存在？ → 执行
    /usr/bin/python3       → 存在？ → 执行
    /bin/python3           → 存在？ → 执行
    ...
    ↓ 全部不存在
报错: command not found

2.3 PATH 的安全考虑

顺序敏感：PATH 中靠前的目录优先级更高，可能被恶意程序利用
避免包含当前目录：不要将 . 加入 PATH，防止目录注入攻击
权限控制：PATH 中的目录应具有适当的文件系统权限

# 危险！不要这样做
export PATH=.:$PATH

# 如果当前目录有名为 ls 的恶意脚本
# 执行 ls 时会优先运行恶意脚本而非系统 ls

3. 跨平台配置

3.1 Linux / macOS

配置文件加载顺序：

登录 Shell:
  /etc/profile → ~/.bash_profile → ~/.bashrc

非登录 Shell:
  ~/.bashrc

Zsh:
  /etc/zshenv → ~/.zshenv → ~/.zshrc → ~/.zlogin

常用操作：

# 查看所有环境变量
env
printenv

# 查看单个变量
echo $HOME
echo $JAVA_HOME

# 设置临时变量（仅当前会话有效）
export MY_VAR="hello"

# 追加到 PATH
export PATH="$HOME/.local/bin:$PATH"

# 永久生效：写入配置文件
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 删除变量
unset MY_VAR

3.2 Windows

配置方式：

系统设置：设置 → 系统 → 关于 → 高级系统设置 → 环境变量
命令行：

# 查看所有环境变量
Get-ChildItem Env:

# 查看单个变量
$env:PATH
$env:JAVA_HOME

# 设置临时变量（仅当前会话）
$env:MY_VAR = "hello"

# 追加到 PATH
$env:PATH += ";C:\MyTools\bin"

# 永久设置（用户级）
[Environment]::SetEnvironmentVariable("MY_VAR", "hello", "User")

# 永久设置（系统级，需管理员权限）
[Environment]::SetEnvironmentVariable("MY_VAR", "hello", "Machine")

# 永久追加 PATH
$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
[Environment]::SetEnvironmentVariable("PATH", "$currentPath;C:\MyTools\bin", "User")

3.3 跨平台环境变量管理

在 Node.js 项目中，推荐使用 .env 文件管理环境变量：

# .env 文件
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=sk-xxxxx
NODE_ENV=development

// 使用 dotenv 加载
require('dotenv').config();

console.log(process.env.DATABASE_URL);
console.log(process.env.NODE_ENV);

安全规则：

.env 文件必须加入 .gitignore，绝不提交到版本控制
提供 .env.example 作为模板，列出所需变量但不包含真实值
生产环境使用 CI/CD 的密钥管理功能，而非 .env 文件

4. 常见开发工具的环境变量

4.1 编程语言相关

工具	变量	作用
Java	`JAVA_HOME`	JDK 安装路径
Python	`PYTHONPATH`	Python 模块搜索路径
Node.js	`NODE_PATH`	Node.js 模块搜索路径
Go	`GOPATH`	Go 工作空间路径
Go	`GOROOT`	Go 安装路径
Rust	`CARGO_HOME`	Cargo 包管理器路径

4.2 代理与网络

# HTTP 代理
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.example.com

# npm 代理
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

5. 问题排查

5.1 常见问题

问题	原因	解决方案
`command not found`	可执行文件不在 PATH 中	将其所在目录加入 PATH
`permission denied`	文件无执行权限	`chmod +x filename`
变量设置后不生效	未 source 配置文件	`source ~/.bashrc`
Windows 路径分隔符错误	使用了 `/` 而非 `;`	Windows 用 `;`，Unix 用 `:`

5.2 调试技巧

# 检查命令的实际路径
type -a python3    # 显示所有匹配位置
command -v node    # 显示第一个匹配位置

# 检查环境变量是否已设置
[ -z "$JAVA_HOME" ] && echo "未设置" || echo "已设置: $JAVA_HOME"

# 查看进程的环境变量
cat /proc/$PID/environ | tr '\0' '\n'  # Linux

Windows 系统变量查看

基本写法：查看所有环境变量（CMD） set

# 列出所有环境变量
set

基本写法：查看特定变量（CMD） echo %<变量名>%

# 查看指定环境变量的值
echo %PATH%

基本写法：查看所有变量（PowerShell） Get-ChildItem Env:

# PowerShell 列出所有环境变量
Get-ChildItem Env:

基本写法：查看特定变量（PowerShell） $env:<变量名>

# PowerShell 查看指定变量
$env:PATH

Windows 环境变量设置

基本写法：临时设置变量（CMD） set <变量名>=<值>

# 仅当前会话有效的变量
set MY_VAR=hello

基本写法：永久设置用户变量（CMD） setx <变量名> "<值>"

# 永久写入用户环境变量
setx JAVA_HOME "C:\Program Files\Java\jdk-21"

基本写法：永久设置系统变量（CMD） setx <变量名> "<值>" /M

# 写入系统级环境变量（需管理员权限）
setx PATH "%PATH%;C:\new\path" /M

基本写法：PowerShell 设置用户变量 [Environment]::SetEnvironmentVariable("<变量名>", "<值>", "User")

# PowerShell 永久设置用户变量
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Java\jdk-21", "User")

基本写法：PowerShell 设置系统变量 [Environment]::SetEnvironmentVariable("<变量名>", "<值>", "Machine")

# PowerShell 设置系统级变量（需管理员权限）
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\new", "Machine")

Windows PATH 管理

基本写法：追加路径到 PATH setx PATH "%PATH%;<新路径>"

# 将新路径追加到 PATH 环境变量
setx PATH "%PATH%;C:\my\tools"

基本写法：PowerShell 追加 PATH $env:PATH = $env:PATH + ";<新路径>"

# 临时追加路径到当前会话 PATH
$env:PATH = $env:PATH + ";C:\my\tools"

基本写法：PowerShell 永久追加用户 PATH $old = [Environment]::GetEnvironmentVariable("PATH", "User"); [Environment]::SetEnvironmentVariable("PATH", $old + ";<新路径>", "User")

# 永久追加路径到用户 PATH
$old = [Environment]::GetEnvironmentVariable("PATH", "User")
[Environment]::SetEnvironmentVariable("PATH", $old + ";C:\my\tools", "User")

Linux/macOS 环境变量

基本写法：临时设置变量 export <变量名>=<值>

# 仅当前 shell 会话有效
export MY_VAR=hello

基本写法：写入 bash 配置文件 echo 'export <变量名>=<值>' >> ~/.bashrc

# 追加到 bashrc 实现永久生效
echo 'export JAVA_HOME=/usr/lib/jvm/java-21' >> ~/.bashrc

基本写法：写入 zsh 配置文件 echo 'export <变量名>=<值>' >> ~/.zshrc

# 追加到 zshrc（macOS 默认 shell）
echo 'export JAVA_HOME=/usr/lib/jvm/java-21' >> ~/.zshrc

基本写法：追加路径到 PATH export PATH=$PATH:<新路径>

# 将新路径追加到 PATH 变量
export PATH=$PATH:/usr/local/bin

基本写法：前置路径到 PATH export PATH=<新路径>:$PATH

# 将新路径前置到 PATH（优先级更高）
export PATH=/usr/local/bin:$PATH

配置文件重新加载

基本写法：重新加载 bashrc source ~/.bashrc

# 重新加载 bash 配置文件
source ~/.bashrc

基本写法：重新加载 zshrc source ~/.zshrc

# 重新加载 zsh 配置文件
source ~/.zshrc

基本写法：重新加载 profile source ~/.profile

# 重新加载 profile 文件
source ~/.profile

变量删除

基本写法：删除用户变量（PowerShell） [Environment]::SetEnvironmentVariable("<变量名>", $null, "User")

# 删除用户级环境变量
[Environment]::SetEnvironmentVariable("MY_VAR", $null, "User")

基本写法：删除 setx 设置的变量 reg delete "HKCU\Environment" /F /V <变量名>

# 通过注册表删除用户环境变量
reg delete "HKCU\Environment" /F /V MY_VAR

基本写法：删除 bash 中的变量 unset <变量名>

# 删除当前 shell 中的环境变量
unset MY_VAR

环境变量与 PATH

1. 环境变量基础#

1.1 什么是环境变量#

1.2 环境变量的分类#

1.3 环境变量的生命周期#

2. PATH 机制详解#

2.1 PATH 的工作原理#

2.2 PATH 搜索流程#

2.3 PATH 的安全考虑#

3. 跨平台配置#

3.1 Linux / macOS#

3.2 Windows#

3.3 跨平台环境变量管理#

4. 常见开发工具的环境变量#

4.1 编程语言相关#

4.2 代理与网络#

5. 问题排查#

5.1 常见问题#

5.2 调试技巧#

Windows 系统变量查看#

Windows 环境变量设置#

Windows PATH 管理#

Linux/macOS 环境变量#

配置文件重新加载#

变量删除#