/etc/environment语法严格，仅支持key="value"格式，不支持export、变量展开或shell语法；错误配置会导致path丢失甚至无法登录，生效需重新登录或重启。
/etc/environment 文件的语法限制必须遵守
这个文件不是 shell 脚本，它由 PAM 模块直接读取，不执行任何命令。所以 export、$PATH 展开、条件判断、变量拼接全都不支持。
常见错误是写成：PATH="$PATH:/opt/myapp/bin" 或 export JAVA_HOME=/usr/lib/jvm/java-17 —— 这两种写法都会让整个文件加载失败，导致后续环境变量（包括 PATH）丢失，甚至可能引发登录黑屏或终端无法启动。
正确写法只有一种格式：KEY="value"，且 value 中不能含未转义的空格或特殊字符。例如：
JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64" PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/opt/myapp/bin"
注意：PATH 必须完整重写，不能基于原有值追加；如果漏掉系统默认路径（如 /usr/bin），会导致 ls、cp 等基础命令找不到。
配置后不生效？检查会话类型和加载时机
/etc/environment 是登录时由 PAM 加载的第一批环境变量，但它**不会被 source 命令识别**。执行 source /etc/environment 不仅无效，还可能报错或污染当前 shell。
验证是否生效，只能通过新开一个**登录式 shell**：
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
- 图形界面：注销再登录（不是重启应用或刷新桌面）
- SSH：断开连接后重连
- TTY：按
Ctrl+Alt+F2切到字符终端，用账户密码重新登录
如果只是在现有终端里执行 echo $JAVA_HOME 为空，不代表配置失败 —— 它本来就不该在非登录 shell 中出现。可以用 loginctl show-user $USER | grep -i environment 查看 PAM 实际加载的变量。
PATH 覆盖风险高，优先考虑 /etc/profile.d/ 替代方案
直接在 /etc/environment 里写死 PATH 极易出错。系统升级或发行版变更可能导致默认路径变化，而你写的 PATH 不会自动同步。
更安全的做法是用 /etc/profile.d/ 下的脚本：
sudo tee /etc/profile.d/myapp.sh <p>这个方式保留了 shell 解析能力，支持变量展开和追加，且所有登录用户都会加载，又不会干扰 PAM 的基础环境初始化。运维中绝大多数全局变量（尤其是依赖 PATH 扩展的）都应该走这条路，而不是硬塞进 <code>/etc/environment</code>。</p> <h3>配置错误导致无法登录时的紧急恢复方法</h3> <p>如果改完 <code>/etc/environment</code> 后图形界面卡在登录页，或 SSH 拒绝连接，大概率是语法错误让 PAM 加载中断。此时需进入恢复模式：</p>
- 重启，在 GRUB 菜单按
e编辑启动项，找到linux行末尾添加systemd.unit=multi-user.target，然后Ctrl+X启动 - 用 root 登录后执行：
sudo nano /etc/environment，删掉非法行或恢复备份 - 确认语法无误后，重启即可
关键点：不要试图在故障会话里修配置 —— 失效的环境变量会让 vi、nano 甚至 ls 都找不到，务必用绝对路径调用编辑器，例如 /usr/bin/nano。
