Mac Mini：开发环境配置指南：从零安装 Homebrew、Python、Git、Node 和 UV 工具
文章目录
前言
本文将详细介绍如何在 Mac Mini 上从零开始配置完整的开发环境，包括 Homebrew 包管理器的安装、Python 环境配置、Git 版本控制工具、Node.js 运行时以及新兴的高性能 Python 包管理工具 UV 的安装与使用。
一、Homebrew 安装与配置
1. 安装 Homebrew
Homebrew 是 macOS 上最受欢迎的包管理器，当Homebrew安装成功后，git、node、python等都可以通过Homebrew来管理，，安装命令如下：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"2. 配置环境变量
安装完成后，根据提示将 Homebrew 添加到 PATH：
echo'eval "$(/opt/homebrew/bin/brew shellenv)"'>> ~/.zshrc source ~/.zshrc 注意：
如果你使用的是 旧版 macOS（10.14 或更早），可能默认是 bash，则改成 ~/.bash_profile 而不是
~/.zshrc。
如果是 M1/M2 Mac，Homebrew 默认安装在 /opt/homebrew，而 Intel Mac 是在 /usr/local。
3. 验证安装
brew --version 4. 常见问题解决
- 安装缓慢：可使用国内镜像源加速：
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 权限问题：避免使用 sudo 安装
- 卸载方法：使用官方卸载脚本
进度判断技巧：
如果终端长时间无输出：
按 Control+T 可显示隐藏的传输进度
通过活动监视器查看 curl 或 git 进程是否在活动
二、Python 环境配置
1. 通过 Homebrew 安装 Python
brew install python 2. 验证安装
python3 --version pip3 --version 3. 虚拟环境管理
推荐使用 venv 创建隔离环境：
python3 -m venv myenv source myenv/bin/activate 三、Git 版本控制工具
1. 安装 Git
brew installgit2. 基本配置
git config --global user.name "Your Name"git config --global user.email "[email protected]"3. 验证安装
git --version 四、Node.js 安装与管理
1. 通过 Homebrew 安装 Node.js
brew install node 2. 验证安装
node --version npm --version 3. 使用 nvm 管理多版本（可选）
brew install nvm mkdir ~/.nvm 五、UV 工具安装与使用
1. 什么是 UV？
UV 是由 Astral 公司开发的 Rust 语言编写的高性能 Python 包管理工具，旨在替代 pip 和 pip-tools。
2. 安装 UV
curl -LsSf https://astral.sh/uv/install.sh |sh3. 配置环境变量
echo'export PATH="$HOME/.local/bin:$PATH"'>> ~/.zshrc source ~/.zshrc 4. 基本使用
| 功能 | 传统命令 | UV 命令 | 速度提升 |
|---|---|---|---|
| 安装包 | pip install numpy | uv pip install numpy | 5-10x |
| 安装项目依赖 | pip install -r req.txt | uv pip install -r req.txt | 8-15x |
| 生成锁定文件 | pip-compile | uv pip compile | 50x+ |
| 创建虚拟环境 | python -m venv | uv venv | 3x |
5. 国内用户加速
exportUV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple 六、完整开发环境验证
1. 检查所有工具版本
brew --version python3 --version git --version node --version uv --version 2. 创建并运行示例项目
mkdir myproject &&cd myproject uv venv .venv source .venv/bin/activate uv pip install fastapi uvicorn 七、性能优化建议
- 使用 UV 替代 pip 进行包管理
为常用命令创建别名：
echo"alias uvinstall='uv pip install -r requirements.txt'">> ~/.zshrc 定期更新所有工具：
brew update && brew upgrade 结语
通过本文的步骤，你已经成功在 Mac Mini 上配置了完整的开发环境。从基础的 Homebrew 和 Python，到版本控制工具 Git，再到 Node.js 运行时，最后是新兴的高性能 Python 包管理工具 UV，这套环境将满足大多数开发需求。
UV 工具的出现特别值得关注，它通过 Rust 实现的底层优化，为 Python 包管理带来了革命性的速度提升。建议开发者尝试将现有项目迁移到 UV，体验更高效的开发工作流。
