cargo 等工具默认安装在 $home/.cargo/bin，需手动将其加入 shell 的 path 才能全局调用；macos catalina 及之后默认使用 zsh，应将 export path="$home/.cargo/bin:$path" 写入 ~/.zshrc 并执行 source ~/.zshrc。
安装 rustup 后，cargo 的可执行文件（cargo、rustc 等）默认放在 $home/.cargo/bin 目录下，但 macos 终端默认不把这个路径加入 path，所以你运行 cargo --version 会提示 command not found。关键不是“装了没”，而是让 shell 能找到它。
确认当前使用的 Shell
macOS Catalina（10.15）及之后系统默认用 zsh；更早版本默认是 bash。先查清楚：
- 运行
echo $SHELL，输出类似/bin/zsh或/bin/bash - 也可以看配置文件是否存在：
ls ~/.zshrc或ls ~/.bash_profile
把 Cargo bin 目录加进 PATH
只需一行命令，追加到对应 shell 的启动配置文件中：
- 如果你用 zsh（绝大多数新 Mac）：
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 如果你用 bash：
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile
执行完后，新开一个终端或直接运行 cargo --version 和 rustc --version，应能正常显示版本号。
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
临时生效 vs 永久生效
安装脚本运行后会提示你执行 source $HOME/.cargo/env ——这属于临时生效，只对当前终端窗口有效。关掉就失效。真正要一劳永逸，必须写入 shell 配置文件（如 .zshrc），否则每次开新终端都得手动 source。
验证 PATH 是否正确包含
运行 echo $PATH，检查输出里是否含有 /Users/你的用户名/.cargo/bin。如果没有，说明上面的写入没成功，可手动用文本编辑器打开 ~/.zshrc，确认最后一行确实是 export PATH="$HOME/.cargo/bin:$PATH"，然后再次 source ~/.zshrc。
