Mac Mini：开发环境配置指南：从零安装 Homebrew、Python、Git、Node 和 UV 工具_homebrew python

文章目录

• • 前言
  • 一、Homebrew 安装与配置
  • • 1. 安装 Homebrew
    • 2. 配置环境变量
    • 3. 验证安装
    • 4. 常见问题解决
  • 二、Python 环境配置
  • • 1. 通过 Homebrew 安装 Python
    • 2. 验证安装
    • 3. 虚拟环境管理
  • 三、Git 版本控制工具
  • • 1. 安装 Git
    • 2. 基本配置
    • 3. 验证安装
  • 四、Node.js 安装与管理
  • • 1. 通过 Homebrew 安装 Node.js
    • 2. 验证安装
    • 3. 使用 nvm 管理多版本（可选）
  • 五、UV 工具安装与使用
  • • 1. 什么是 UV？
    • 2. 安装 UV
    • 3. 配置环境变量
    • 4. 基本使用
    • 5. 国内用户加速
  • 六、完整开发环境验证
  • • 1. 检查所有工具版本
    • 2. 创建并运行示例项目
  • 七、性能优化建议
  • 结语

前言

本文将详细介绍如何在 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)\"\' >> ~/.zshrcsource ~/.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 --versionpip3 --version

3. 虚拟环境管理

推荐使用 venv 创建隔离环境：

python3 -m venv myenvsource myenv/bin/activate

三、Git 版本控制工具

1. 安装 Git

brew install git

2. 基本配置

git config --global user.name \"Your Name\"git config --global user.email \"your.email@example.com\"

3. 验证安装

git --version

四、Node.js 安装与管理

1. 通过 Homebrew 安装 Node.js

brew install node

2. 验证安装

node --versionnpm --version

3. 使用 nvm 管理多版本（可选）

brew install nvmmkdir ~/.nvm

五、UV 工具安装与使用

1. 什么是 UV？

UV 是由 Astral 公司开发的 Rust 语言编写的高性能 Python 包管理工具，旨在替代 pip 和 pip-tools。

2. 安装 UV

curl -LsSf https://astral.sh/uv/install.sh | sh

3. 配置环境变量

echo \'export PATH=\"$HOME/.local/bin:$PATH\"\' >> ~/.zshrcsource ~/.zshrc

4. 基本使用

5. 国内用户加速

export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple

六、完整开发环境验证

1. 检查所有工具版本

brew --versionpython3 --versiongit --versionnode --versionuv --version

2. 创建并运行示例项目

mkdir myproject && cd myprojectuv venv .venvsource .venv/bin/activateuv pip install fastapi uvicorn

七、性能优化建议

1. 定期更新所有工具：

   brew update && brew upgrade

2. 使用 UV 替代 pip 进行包管理

3. 为常用命令创建别名：

   echo \"alias uvinstall=\'uv pip install -r requirements.txt\'\" >> ~/.zshrc

结语

通过本文的步骤，你已经成功在 Mac Mini 上配置了完整的开发环境。从基础的 Homebrew 和 Python，到版本控制工具 Git，再到 Node.js 运行时，最后是新兴的高性能 Python 包管理工具 UV，这套环境将满足大多数开发需求。

UV 工具的出现特别值得关注，它通过 Rust 实现的底层优化，为 Python 包管理带来了革命性的速度提升。建议开发者尝试将现有项目迁移到 UV，体验更高效的开发工作流。