ubuntu 设置系统环境变量

在 Ubuntu 中设置系统环境变量会影响所有用户和系统服务，通常用于配置全局路径、库搜索路径或系统级工具的参数。以下是详细步骤和注意事项：

---

一、系统环境变量的配置文件

Ubuntu 中系统级环境变量主要通过以下文件配置：

1. /etc/environment
   • 用于设置 非交互式 Shell 的全局变量（如 PATH、JAVA_HOME）。
   • 格式：KEY=value（不支持变量扩展，如 $PATH）。
   • 示例：

     PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/opt/custom/bin"
     JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

2. /etc/profile
   • 适用于 所有用户的登录 Shell（如终端登录或 SSH）。
   • 支持脚本逻辑和变量扩展（如 $PATH）。
   • 示例：

     # 添加自定义路径到 PATH
     if [ -d "/opt/custom/bin" ]; then
         PATH="/opt/custom/bin:$PATH"
     fi
     export PATH
     
     # 设置全局变量
     export SYSTEM_CONFIG="/etc/system.conf"

3. /etc/profile.d/*.sh
   • 推荐方式：将自定义脚本放在 /etc/profile.d/ 目录下（文件名以 .sh 结尾）。
   • 示例：

     # 创建文件 /etc/profile.d/custom_env.sh
     echo 'export CUSTOM_VAR="value"' | sudo tee /etc/profile.d/custom_env.sh
     sudo chmod +x /etc/profile.d/custom_env.sh

4. /etc/ld.so.conf 和 /etc/ld.so.conf.d/*.conf
   • 用于配置 动态库搜索路径（影响 ldconfig 和运行时链接）。
   • 示例：

     # 创建文件 /etc/ld.so.conf.d/custom_libs.conf
     echo "/opt/custom/lib" | sudo tee /etc/ld.so.conf.d/custom_libs.conf
     sudo ldconfig # 更新库缓存

---

二、设置系统环境变量的步骤

方法 1：通过 /etc/environment（推荐简单变量）

1. 编辑文件：

   sudo nano /etc/environment

   添加变量（如 PATH）：

   PATH="/new/path:$PATH"

2. 保存并退出（Ctrl+X → Y → Enter）。
3. 生效方式：
   • 重新登录用户。
   • 或重启系统。

方法 2：通过 /etc/profile 或 /etc/profile.d/（推荐脚本逻辑）

1. 创建脚本文件：

   sudo nano /etc/profile.d/custom_env.sh

   添加内容：

   # 示例：添加路径并设置变量
   if [ -d "/opt/custom/bin" ]; then
       PATH="/opt/custom/bin:$PATH"
   fi
   export PATH
   export SYSTEM_VAR="global_value"

2. 赋予执行权限：

   sudo chmod +x /etc/profile.d/custom_env.sh

3. 生效方式：
   • 运行 source /etc/profile 或重新登录。

方法 3：通过 /etc/ld.so.conf.d/（动态库路径）

1. 创建配置文件：

   sudo nano /etc/ld.so.conf.d/custom_libs.conf

   添加库路径：

   /opt/custom/lib
   /usr/local/cuda/lib64 # 示例：NVIDIA CUDA 库

2. 更新库缓存：

   sudo ldconfig

---

三、验证系统环境变量

1. 查看所有环境变量：

   printenv

2. 检查特定变量（如 PATH）：

   echo $PATH

3. 检查动态库路径：

   ldconfig -p | grep libname # 确认库是否被加载

---

四、注意事项

1. 权限问题：修改系统文件需 sudo 权限。
2. 语法错误：
   • /etc/environment 不支持变量扩展（如 $PATH），需直接写完整路径。
   • /etc/profile 和 /etc/profile.d/*.sh 支持脚本语法。
3. 生效顺序：
   • 系统启动时加载顺序：/etc/environment → /etc/profile → /etc/profile.d/*.sh。
4. 安全性：
   • 避免在系统文件中暴露敏感信息（如密码）。
   • 修改前备份文件：

     sudo cp /etc/environment /etc/environment.bak

5. 重启要求：
   • 部分配置（如 /etc/environment）需重新登录或重启生效。

---

五、常见用例

1. 添加全局路径：

   # /etc/environment
   PATH="/opt/custom/bin:/opt/custom/sbin:$PATH"

2. 设置 Java 主目录：

   # /etc/environment
   JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"

3. 配置动态库路径：

   # /etc/ld.so.conf.d/opencv.conf
   /usr/local/lib/opencv4

---

通过以上方法，你可以安全地为 Ubuntu 系统配置全局环境变量，确保所有用户和进程都能访问所需的路径和库。