macOS终端环境配置的核心是正确管理PATH环境变量，先用echo $SHELL确认shell类型（zsh用户编辑~/.zshrc，bash用户编辑~/.bash_profile），添加export PATH="/opt/homebrew/bin:$PATH"后source生效，并用echo $PATH和which验证。
macOS 终端环境配置的核心是让命令能被系统“认出来”，关键就是管好 PATH 环境变量。它是一条路径列表，终端靠它知道去哪找 python、flutter、mvn 这类命令。配错了或没生效，就会提示 command not found。
先确认你用的是哪个 Shell
macOS Catalina（10.15）起默认用 zsh，老系统可能是 bash。配错文件，改了也白改：
- 运行
echo $SHELL，如果输出/bin/zsh，就该编辑~/.zshrc - 如果输出
/bin/bash，就该编辑~/.bash_profile - 别在
.bash_profile里加 zsh 的配置，也别指望.zshrc对 bash 生效
永久添加 PATH（推荐日常使用）
以添加 Homebrew 的路径 /opt/homebrew/bin 为例：
- 用
nano ~/.zshrc（zsh 用户）或nano ~/.bash_profile（bash 用户）打开配置文件 - 在文件末尾新增一行：
export PATH="/opt/homebrew/bin:$PATH"（把新路径放前面，优先匹配） - 按
Control + O保存 → 回车确认 →Control + X退出 - 立刻生效：
source ~/.zshrc或source ~/.bash_profile
验证是否真生效
别只信“改完了”，一定要检查：
- 运行
echo $PATH，看输出里有没有你刚加的路径 - 运行
which python3或which mvn，看返回的路径是否来自你新加的目录 - 如果还是
command not found，检查：路径拼写是否正确、目录是否存在（ls -d /opt/homebrew/bin）、该目录下是否有可执行文件、是否漏了source步骤
GUI 应用（如 VS Code、PyCharm）读不到终端 PATH 怎么办
图形界面程序不继承终端的 shell 环境，它们从 launchd 读环境变量。解决方法是让 launchd 也加载你的 PATH：
- 创建或编辑
~/Library/LaunchAgents/environment.plist - 填入标准 plist 格式，声明
PATH变量值（内容需严格符合 XML 规范） - 保存后运行
launchctl load ~/Library/LaunchAgents/environment.plist - 重启 GUI 应用，再打开内置终端试试
