在macOS上配好Rust环境的核心是让rustc、cargo、rust-analyzer和调试器协同工作，需用rustup安装（禁用brew）、正确加载PATH、运行rustup default stable初始化工具链，并推荐配置USTC镜像加速。
在 macos 上配好 rust 环境，核心是让 rustc、cargo、rust-analyzer 和调试器四者协同工作。不是装上就行，而是每一步都得对齐——尤其要注意 rustup 安装方式、环境变量加载、工具链初始化这三处最容易出错的地方。
用 rustup 正确安装并初始化工具链
别用 brew install rust —— 它装的是静态打包版，不支持 nightly，无法更新组件，也不带 rust-analyzer 所需的元数据。必须用官方 rustup：
- 先确保 Xcode 命令行工具已就位：
xcode-select --install - 运行安装脚本：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh，按回车选默认选项 - 立即加载环境：
source $HOME/.cargo/env - 设稳定版为默认工具链：
rustup default stable（跳过这步，后续 cargo 命令会报“no default toolchain configured”） - 验证：
rustc --version和cargo --version都应正常输出版本号
解决 command not found：手动补全 PATH
即使 rustup 装完了，终端仍可能提示 command not found，说明 $HOME/.cargo/bin 没进 PATH。需根据 shell 类型显式追加：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 查当前 shell：
echo $SHELL（macOS Catalina 及以后默认是/bin/zsh） - zsh 用户执行：
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - bash 用户执行：
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile - 验证：
which rustc应返回/Users/xxx/.cargo/bin/rustc
Cargo 依赖管理与常用命令
Cargo 是 Rust 的构建系统和包管理器，不只是“编译器前端”，它负责项目结构、依赖下载、测试运行、文档生成等整套流程：
- 新建项目：
cargo new hello→ 自动生成Cargo.toml（依赖配置）和src/main.rs（入口文件） - 添加依赖：在
Cargo.toml的[dependencies]下写入，例如serde = { version = "1.0", features = ["derive"] } - 下载并锁死依赖：
cargo build（首次会拉取 crates.io 索引并下载依赖，生成Cargo.lock） - 快速检查语法：
cargo check（比 build 更快，不生成可执行文件） - 运行项目：
cargo run；发布构建：cargo build --release
加速依赖下载：配置 USTC 国内镜像
Crates.io 官方源在国内访问慢，常卡在 Updating crates.io index。推荐提前配置 USTC 镜像：
- 编辑
~/.cargo/config.toml（若不存在则新建），填入：
index = "https://mirrors.ustc.edu.cn/crates.io-index"
[source.crates-io]
replace-with = "ustc"
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"
- 保存后，后续所有
cargo build或cargo add都会走国内镜像，速度明显提升
