冠军资讯
代码一只喵作为一名后端开发，经常需要在 Mac 上配置各种全局变量，比如 JDK、Maven、Gradle 的安装路径，或者一些自定义的脚本命令。看似简单的操作，却经常遇到各种奇奇怪怪的问题，例如终端重启后变量失效，不同终端之间变量不生效等等。今天就来彻底搞清楚 Mac 上添加全局变量的正确姿势，以及背后的原理。
环境变量加载机制
首先，我们需要了解 Mac 环境变量的加载机制。Mac 在启动时会读取多个配置文件，这些文件定义了不同作用域的环境变量。主要涉及的文件包括：
/etc/profile：系统全局配置文件，对所有用户生效，不建议修改。/etc/paths：系统全局 PATH 变量配置文件，存放可执行程序的路径，同样不建议直接修改。~/.bash_profile：用户级别的 profile 文件，只对当前用户生效。早期 macOS 版本默认使用，推荐使用.zprofile。~/.zprofile：用户级别的 zsh profile 文件，只对当前用户生效。macOS Catalina 之后默认使用 zsh，推荐使用此文件配置。~/.bashrc：每次打开新的终端窗口都会执行此文件。但通常.bashrc会被.bash_profile调用，所以环境变量通常写在.bash_profile中。~/.zshrc：每次打开新的终端窗口都会执行此文件。但通常.zshrc会被.zprofile调用，所以环境变量通常写在.zprofile中。~/.zshenv：对于所有 zsh 实例生效，包括非交互式 shell。优先级最高，容易造成环境变量污染，谨慎使用。
环境变量加载顺序大致是：/etc/profile -> ~/.bash_profile 或 ~/.zprofile -> ~/.bashrc 或 ~/.zshrc -> ~/.zshenv 。
添加全局变量的正确方法
既然知道了环境变量的加载机制，那么添加全局变量也就有了章法。推荐使用 .zprofile 文件来配置用户级别的环境变量。
打开
.zprofile文件：如果
.zprofile文件不存在，则创建它。可以使用vim或nano等编辑器。touch ~/.zprofile open -e ~/.zprofile # 使用 TextEdit 打开添加环境变量：
在
.zprofile文件中添加需要设置的环境变量。例如，添加 JAVA_HOME 环境变量：export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_201.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH这里需要注意的是，
export命令用于声明环境变量，PATH变量用于指定可执行程序的搜索路径，务必将$JAVA_HOME/bin添加到PATH变量中。使环境变量生效：
修改
.zprofile文件后，需要手动执行source ~/.zprofile命令使环境变量生效，或者重启终端。source ~/.zprofile
实战避坑经验总结
- 避免修改系统全局配置文件：
/etc/profile和/etc/paths是系统级别的配置文件，修改它们可能会影响其他用户甚至整个系统，尽量不要修改。 - 选择合适的配置文件：推荐使用
.zprofile配置用户级别的环境变量。 如果使用.bash_profile，确保.bash_profile文件中包含source ~/.bashrc或类似语句，以便加载.bashrc中的环境变量。 - 注意环境变量的优先级：环境变量的优先级从低到高依次是：
/etc/profile->~/.bash_profile或~/.zprofile->~/.bashrc或~/.zshrc->~/.zshenv。如果同一个变量在多个文件中定义，那么优先级高的文件中的定义会覆盖优先级低的文件中的定义。 - 检查环境变量是否生效：可以使用
echo $VARIABLE_NAME命令来检查环境变量是否生效。如果环境变量没有生效，可以尝试重启终端或者重新执行source ~/.zprofile命令。 - PATH 变量的顺序：
PATH变量中，越靠前的路径优先级越高。如果多个路径下有同名的可执行程序，那么会执行PATH变量中靠前的路径下的程序。在配置 Nginx 时，这一点尤其重要。很多新手直接使用宝塔面板一键安装 Nginx，却发现终端执行nginx -v看到的版本不是宝塔面板安装的版本，就是因为PATH环境变量中系统自带的 Nginx 路径优先级更高。解决方法就是将宝塔面板 Nginx 的路径添加到PATH变量的最前面。Nginx 反向代理和负载均衡的配置也需要仔细检查。 - export 命令的使用：只有使用
export命令声明的变量才是环境变量，才能被子进程继承。如果没有使用export命令，那么变量只是一个局部变量，只能在当前 shell 中使用。
解决常见问题
问题： 环境变量在当前终端生效，但是打开新的终端窗口后失效。
原因： 环境变量只在当前 shell 会话中生效，没有写入到配置文件中。
解决方法： 将环境变量添加到 .zprofile 文件中，并执行 source ~/.zprofile 命令。
问题： 修改 .zprofile 文件后，环境变量没有生效。
原因： 可能存在以下原因：
.zprofile文件没有正确加载。- 环境变量的语法错误。
- 环境变量被其他配置文件覆盖。
解决方法：
- 确保
.zprofile文件被正确加载。可以尝试重启终端或者重新执行source ~/.zprofile命令。 - 检查环境变量的语法是否正确。可以使用
echo $VARIABLE_NAME命令来检查环境变量的值。 - 检查是否存在其他配置文件覆盖了当前的环境变量。可以使用
env命令查看所有环境变量，并查找是否存在冲突。
掌握了以上技巧，相信你也能轻松搞定 Mac 上的全局变量配置，告别环境变量带来的困扰。
