典型场景:你在 ~/.bashrc 里加了一行 export NODE_ENV=production,SSH 登录后 echo $NODE_ENV 一切正常,服务一用 systemd 拉起来就报错说变量不存在。变量明明写在那,就是没人读。
问题出在对「环境变量属于谁」的理解上。环境变量是进程的属性,跟着进程走,不跟着机器走——写到哪个文件,决定了哪些进程能继承到它。本文按进程继承链把 Linux 环境变量拆成三层:shell、登录会话、systemd,每一层都给验证方法。
变量跟着进程走,不跟着配置文件走
内核里每个进程都有一份环境字符串数组,格式固定为 NAME=value:名字区分大小写,不能含等号;值可以是任意字符串。进程通过 fork 创建子进程时,子进程拿到的是父进程环境的副本;通过 exec 启动新程序时,环境传递过去,也可以在传递前改写。配置文件从不直接参与。它们只是被某个父进程读取,变量再由父进程传下去。搞清「谁的子进程会读到这个文件」,环境变量的一切疑问就都变成了继承链问题。
日常查看和临时设置:
printenv PATH # 看单个变量
env # 列出当前进程全部环境
TZ=Asia/Shanghai date # 前缀写法:变量只对这一个命令生效
unset TZ # 删除变量
env -i bash # 起一个几乎空环境的 shell,用来排查"默认值污染"
几个出现频率最高的变量,各自控制什么:
| 变量 | 控制什么 | 典型踩坑点 |
|---|---|---|
PATH | 命令的搜索目录列表,冒号分隔 | cron 里 PATH 只有 /usr/bin:/bin,命令找不到 |
HOME | 当前用户主目录 | 脚本写死 /root 而不是 $HOME |
LANG | 语言与编码 | 不设时程序输出英文或乱码 |
EDITOR | 程序调用编辑器的默认值 | crontab -e、git commit 的体验全靠它 |
TMPDIR | 临时目录前缀 | 磁盘分区满了才想起它 |
TZ | 时区 | 日志时间对不上八成是它 |
shell 层:export 与三处配置文件怎么分工
shell 里 FOO=bar 只创建 shell 变量,子进程看不到;加上 export 才进入环境。验证一下:
FOO=bar bash -c 'echo $FOO' # 输出空
export FOO=bar
bash -c 'echo $FOO' # 输出 bar
追加已有变量用引用自身的写法,最常见的是给 PATH 补目录:export PATH="$HOME/bin:$PATH"。写在前面优先匹配,适合想让自装版本盖过系统版本的场景。
配置文件有三处值得用,分工不同:
| 文件 | 谁读它 | 时机 | 适合放什么 |
|---|---|---|---|
~/.bashrc | 每个交互式 shell | 每开一个终端 | 交互配置为主:别名、提示符、补全 |
~/.profile | 登录 shell | 每次登录一次 | 给自己用的环境变量 |
/etc/profile.d/*.sh | 所有用户的登录 shell | 每次登录一次 | 全员共享、需要 shell 语法的变量 |
这里的坑在「登录 shell」三个字。SSH 交互登录会读 .profile,但 ssh host 'command' 这种非交互执行、以及脚本里的子 shell,都不保证读它。Ubuntu 的 bash 在 .bashrc 开头有一段非交互直接 return 的判断,所以靠 .bashrc 传变量给脚本属于碰运气。给程序消费的变量,别放在交互配置文件里。
/etc/environment:PAM 的文件,写不了 shell 语法
Ubuntu 24.04 默认的 /etc/environment 只有一行:
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin"
它由 PAM 的 pam_env 模块在登录时读取,覆盖 SSH 登录、控制台登录这些入口。代价是语法极窄:只认 KEY=value,等号右边不做任何展开,export 不能写,MAIL=$HOME/Maildir 这种引用会原样变成字面量 $HOME/Maildir。
想给所有登录用户一个默认编辑器,就写静态值:
# /etc/environment
EDITOR=vim
生效要重新登录——退出再 ssh 上来,printenv EDITOR 能看到才算改对。已存在的会话和 systemd 服务都不受影响,后者根本不经过 PAM 登录流程。
给 systemd 服务注入变量:Environment 与 EnvironmentFile
systemd 服务不继承你 shell 里的任何东西,它的环境来自 unit 文件。两种写法:
[Service]
Environment="NODE_ENV=production"
Environment="JAVA_OPTS=-Xms512m -Xmx512m"
EnvironmentFile=/etc/myapp/env
值含空格用引号包起来;每个 Environment 一行。EnvironmentFile 指向一个 KEY=value 格式的文件,语法限制和 /etc/environment 一样——不做 shell 展开,所以密码里的 $ 之类特殊字符不会被解释。路径前加 - 表示文件不存在时不报错,这是 Ubuntu 24.04 上 ssh.service 的实际写法,systemctl cat ssh 可以看到 EnvironmentFile=-/etc/default/ssh,运维改 SSH 启动参数就是往那个文件写 SSHD_OPTS。
改完的生效流程固定三步:
sudo systemctl edit myapp # 或直接改 unit / EnvironmentFile
sudo systemctl daemon-reload # unit 文件变了才需要这步
sudo systemctl restart myapp
systemctl show myapp -p Environment -p EnvironmentFiles # 核对注入结果
systemctl edit 生成 drop-in 覆盖文件,比直接改发行版提供的 unit 更新时不会被覆盖。给用户级服务传变量还有 ~/.config/environment.d/*.conf 一条路,语法同样是 KEY=value,细节见 systemd 文档的 environment.d(5)。
调试:看进程实际拿到了什么
所有「变量到底设没设上」的争论,裁决方式只有一种——直接读目标进程的环境块:
cat /proc/$(systemctl show -p MainPID --value myapp)/environ | tr '\0' '\n'
环境字符串以 NUL 分隔,tr 换行后就是该进程的真实环境。这里看到的和程序拿到的一字不差,任何中间层推测都不作数。
两个相关行为顺手记住:
sudo默认执行env_reset,只保留少数几个变量,PATH 由secure_path重新指定,所以sudo后变量「丢失」是设计行为。需要透传用sudo -E。- cron 的环境极简:
PATH=/usr/bin:/bin,不读任何 profile,调度身份的环境变量一概没有。cron 里跑脚本要么全用绝对路径,要么脚本开头自己设 PATH;对定时任务的可控性要求高一点,直接换 systemd timer(见cron vs systemd timer)。
把五处写入位置汇成一张表,选择逻辑就清楚了:
| 写入位置 | 谁读 | 语法能力 | systemd 服务能看到吗 |
|---|---|---|---|
~/.bashrc | 交互式 shell | 完整 shell 语法 | 否 |
~/.profile | 登录 shell | 完整 shell 语法 | 否 |
/etc/profile.d/*.sh | 所有用户的登录 shell | 完整 shell 语法 | 否 |
/etc/environment | PAM(登录时) | 仅 KEY=value | 否 |
unit 的 Environment= / EnvironmentFile= | systemd | KEY=value、引号 | 是 |
常见问题
Q:变量带空格或特殊字符怎么写?
shell 里 export GREETING="hello world";unit 里 Environment="GREETING=hello world"。值里有 $ 或反引号时注意 shell 会展开,用单引号;EnvironmentFile 里没有 shell,特殊字符原样生效。
Q:改了 /etc/environment 为什么服务没反应?
这个文件只在登录时由 PAM 读,systemd 服务启动路径里没有 PAM。给服务传变量只能走 unit 文件的 Environment= / EnvironmentFile=。
Q:为什么 sudo 之后变量全没了?
sudo 默认重置环境防止变量注入,这属于安全特性。临时透传用 sudo -E,长期需要就写进 /etc/environment 或目标服务的 unit。
Q:ssh host 'env' 看不到 .profile 里的变量?
非交互执行不读登录配置。要保证变量在场,写进 /etc/environment,或者干脆 VAR=x ssh host 'command' 从客户端传——前提是 sshd 配置允许该变量通过(AcceptEnv)。
Q:怎么临时用干净环境测试?
env -i bash --noprofile --norc 起一个近乎空环境的 shell,模拟 cron 或服务进程的视角,很多「我这边明明有」的分歧当场就能复现。
收尾:按继承链选写入位置
环境变量的一切问题都归结为一句话:**先确定派生目标进程的父进程是谁,再把变量写到那个父进程会读的地方。**服务走 systemd,变量进 unit 或 EnvironmentFile;给人用的走登录链,进 profile 层;全员静态值进 /etc/environment;cron 什么都不给,变量自己带。判断改没改对,/proc/PID/environ 说了算。
环境变量没有全局开关,这正是它可靠的原因——每份环境都被明确的父进程递下去,谁改动过、改在哪一层,继承链上一查便知。