第4章 MacOS环境变量配置：zsh与bash的区别、.zshrc文件配置、路径追加与覆盖
MacOS 的环境变量配置，说实话，比 Windows 要「自由」不少。但也正因为自由，新手很容易踩坑。我见过不少同事，从 Windows 切到 Mac 后，第一件事就是对着终端发愣——明明配了环境变量，怎么重启终端就没了？
嗯，这背后其实就两个关键点：你用的什么 Shell，以及你配在了哪个文件里。
4.1 bash 与 zsh：MacOS 的 Shell 变迁史
先说说 Shell 是什么。你可以把它理解成「你和操作系统之间的翻译官」。你敲的命令，Shell 负责解释并执行。而环境变量，就是这位翻译官随身携带的小本本，上面记着各种路径和配置。
MacOS 历史上默认用的是 bash（Bourne Again SHell）。但从 macOS Catalina（10.15）开始，苹果把默认 Shell 换成了 zsh（Z Shell）。
为什么会这样？说白了，bash 的版权协议后来变得不太友好，而 zsh 不仅完全开源，而且对开发者更友好——补全功能强、主题丰富、插件生态好。我个人习惯用 zsh，尤其是配上 oh-my-zsh 之后，工作效率提升很明显。
| 特性 | bash | zsh |
|---|---|---|
| 默认配置文件 | ~/.bash_profile 或 ~/.bashrc |
~/.zshrc |
| 补全功能 | 基础补全 | 智能补全，支持目录、参数、选项 |
| 主题/插件 | 有限 | 丰富（oh-my-zsh 生态） |
| 兼容性 | 兼容 sh | 兼容 bash 大部分语法 |
| MacOS 默认 | Catalina 之前 | Catalina 及之后 |
echo $SHELL 就能看到。输出 /bin/zsh 就是 zsh，/bin/bash 就是 bash。
4.2 核心配置文件：.zshrc
在 zsh 环境下，环境变量的配置主要写在 ~/.zshrc 文件里。这个文件在每次打开新终端窗口时都会被自动加载。
你可能会问：为什么不是 .bash_profile 了？因为系统默认的 Shell 变了，加载的配置文件自然也跟着变。如果你强行把环境变量写在 .bash_profile 里，而你的默认 Shell 是 zsh，那这些变量永远不会生效。
我在项目中遇到过一位同事，折腾了半天发现交叉编译工具链找不到，最后发现他把路径写在了 .bashrc 里，而终端用的是 zsh。嗯，这种问题排查起来其实挺费时间的。
4.2.1 如何编辑 .zshrc
编辑 .zshrc 的方式有很多，我推荐直接用命令行：
# 用 vim 打开（如果你习惯 vim）
vim ~/.zshrc
# 或者用 nano（更简单）
nano ~/.zshrc
# 编辑完成后，记得让配置生效
source ~/.zshrc.zshrc 后，一定要执行 source ~/.zshrc 或者重新打开终端，否则修改不会生效。我曾经见过有人配完环境变量后，直接关掉终端再打开，发现没生效，就以为是配置写错了——其实只是忘了 source。
4.3 路径追加与覆盖：两种核心操作
环境变量里最常操作的就是 PATH。你安装了一个工具，想让系统在任何目录下都能找到它的可执行文件，就得把它的路径加到 PATH 里。
这里有两种方式：追加和覆盖。你想想看，如果搞混了，后果可能很严重。
4.3.1 路径追加（推荐）
追加的意思是在现有路径后面加上新路径。这样既保留了系统原有的搜索顺序，又加入了你的自定义路径。
# 在 .zshrc 中添加以下内容
export PATH="$PATH:/your/custom/path"
# 如果你想把自己的路径放在前面（优先搜索）
export PATH="/your/custom/path:$PATH"这里有个细节：$PATH 代表当前已有的所有路径。用冒号 : 分隔，顺序很重要。
- 追加到末尾：系统先搜索原有路径，找不到才去你的路径找。
- 追加到开头：系统优先搜索你的路径，再搜索原有路径。
我个人习惯把自定义路径追加到开头，尤其是当我想覆盖系统自带的某个工具版本时。比如我安装了新版的 Python，就把它放在 /usr/bin/python 前面。
4.3.2 路径覆盖（危险操作）
覆盖就是直接给 PATH 赋一个新值，把原来的路径全部丢掉。
# 危险！这会覆盖所有系统路径
export PATH="/your/custom/path"这样做之后，你会发现 ls、cd、vim 这些基本命令全都找不到了。因为系统路径被清空了。
export PATH="/opt/toolchain/bin"，结果 source 之后终端直接废了——连 ls 都报 command not found。最后只能靠绝对路径 /bin/ls 把文件改回来。所以，永远不要用覆盖的方式配置 PATH，除非你非常清楚自己在做什么。
4.4 实战：配置 ESP32 开发环境
拿嵌入式开发最常见的 ESP32 来举例。安装完 ESP-IDF 工具链后，通常需要把工具链路径加到环境变量里。
# 打开 .zshrc
nano ~/.zshrc
# 在文件末尾添加以下内容
export IDF_PATH="$HOME/esp/esp-idf"
export PATH="$IDF_PATH/tools:$PATH"
# 保存退出后，执行
source ~/.zshrc这样配置之后，你在任何目录下都能直接使用 idf.py 命令来编译、烧录 ESP32 项目了。
4.5 知识体系：环境变量加载流程
下面这张图帮你理清 MacOS 下环境变量的加载流程。你一看就明白为什么配置文件要写在 .zshrc 里了。
4.6 常见问题与避坑
- 问题：配置了环境变量，但新终端不生效
检查一下你是不是把配置写在了.bash_profile里，而默认 Shell 是 zsh。解决方案：把配置移到.zshrc里。 - 问题：source 之后命令找不到了
八成是你不小心覆盖了PATH。用绝对路径/bin/cat ~/.zshrc查看文件，把export PATH="/your/path"改成export PATH="$PATH:/your/path"。 - 问题：多个路径配置顺序混乱
我建议在.zshrc里统一管理，把所有的export PATH写在一起，用注释标明每个路径的作用。这样以后维护起来一目了然。
.zshrc 里专门划一个区域叫 # ===== Custom PATH =====，所有自定义路径都放在这里。每次新增工具链，只需要在这个区域加一行，不会跟系统配置混在一起。
好了，关于 MacOS 环境变量配置的核心内容就这些。记住：用 zsh 就配 .zshrc，追加路径用 $PATH，千万别覆盖。这三点记住了，你在 Mac 上配置环境变量基本不会出大问题。