小师的Blog
0%

macOS 开发环境工具指南

发表于 分类于
本文字数： 2.5k 阅读时长 ≈ 2 分钟

本文档介绍 macOS 上常见的开发环境工具：Homebrew、nvm、Node.js、pyenv、Python、venv。内容包含概念说明、安装方式、常用命令以及使用示例。

1. Homebrew（brew）

✅ 概念

  • Homebrew 是 macOS 上最常用的包管理器，类似 Linux 的 apt / yum。
  • 用途：安装、升级、卸载命令行工具、开发依赖、服务等。

🧩 安装

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，按提示把 brew 加到 PATH（通常会自动完成）。

🔎 常用命令

1
2
3
4
5
6
7
brew update              # 更新 Homebrew 元数据
brew upgrade             # 升级已安装的软件
brew install <pkg>       # 安装软件包
brew uninstall <pkg>     # 卸载软件包
brew list                # 列出已安装的软件
brew info <pkg>          # 查看软件信息
brew cleanup             # 清理旧版本缓存

2. nvm（Node Version Manager）

✅ 概念

  • nvm 是用于管理多个 Node.js 版本的工具。
  • 通过 nvm，可以为不同项目快速切换 Node.js 版本，避免版本冲突。

🧩 安装

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.6/install.sh | bash

安装后，重启终端或运行：

1
source ~/.nvm/nvm.sh

🔎 常用命令

1
2
3
4
5
6
7
nvm install 20           # 安装 Node.js 20
nvm install --lts        # 安装最新 LTS 版本
nvm ls                   # 列出已安装的版本
nvm ls-remote            # 列出远程可安装版本
nvm use 20               # 切换到 Node.js 20
nvm alias default 20     # 设置默认版本
nvm uninstall 20         # 卸载某个版本

3. Node.js

✅ 概念

  • Node.js 是一个基于 V8 引擎的 JavaScript 运行时，用于运行服务器端脚本。
  • 常用于前端构建工具、开发服务器、脚本自动化等场景。

🧩 安装方式

  1. 通过 nvm（推荐，支持多版本切换）：
    1
    2
    nvm install --lts
    nvm use --lts
  2. 通过 Homebrew（系统安装）：
    1
    brew install node

🔎 常用命令

1
2
3
4
5
6
7
8
node -v                 # 查看 Node.js 版本
npm -v                  # 查看 npm 版本
npm init                # 初始化 package.json
npm install <pkg>       # 安装依赖（本地）
npm install -g <pkg>    # 全局安装依赖
npm update              # 更新依赖
npm uninstall <pkg>     # 卸载依赖
npx <cmd>               # 运行安装在 node_modules 的二进制

4. pyenv

✅ 概念

  • pyenv 是用于管理多个 Python 版本的工具。
  • 可以在系统上同时安装多个 Python（2.x、3.x、pypy 等），并在项目目录中设置特定版本。

🧩 安装（macOS）

1
brew install pyenv

安装后需将 pyenv 初始化脚本加入 shell 启动文件（如 ~/.zshrc / ~/.bash_profile）：

1
2
3
4
5
6
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init --path)"
  eval "$(pyenv init -)"
fi

然后重启终端。

🔎 常用命令

1
2
3
4
5
6
7
pyenv install 3.12.2           # 安装指定 Python 版本
pyenv uninstall 3.12.2         # 卸载指定版本
pyenv versions                 # 列出已安装版本
pyenv global 3.12.2            # 设置全局默认版本
pyenv local 3.12.2             # 在当前目录生成 .python-version
pyenv shell 3.12.2             # 临时切换当前 shell 版本
pyenv which python             # 查找当前版本 Python 路径

5. Python

✅ 概念

  • Python 是一种广泛使用的高级编程语言，适用于脚本、Web 开发、数据分析、自动化等。
  • macOS 通常自带系统 Python（旧版）。建议使用 pyenv 安装和管理自己的版本。

🔎 常用命令

1
2
3
4
5
python --version            # 查看 Python 版本
pip --version               # 查看 pip 版本
python -m pip install <pkg> # 安装包（推荐用 module 方式）
python -m pip list          # 列出已安装包
python -m pip install -U pip

6. venv（Python 内置虚拟环境）

✅ 概念

  • venv 是 Python 自带的虚拟环境模块，用于创建隔离的 Python 环境。
  • 每个虚拟环境有独立的 site-packages，不会影响系统 Python 或其他项目。

🧩 创建与激活

1
2
3
4
python -m venv .venv        # 创建虚拟环境（目录名可自定义）
source .venv/bin/activate    # 激活（macOS / Linux）
# Windows PowerShell:
# .\.venv\Scripts\Activate.ps1

激活后，python/pip 都会指向该虚拟环境。

🔎 常用命令

1
2
3
python -m pip install -r requirements.txt   # 安装依赖
pip freeze > requirements.txt              # 导出依赖
deactivate                                  # 退出虚拟环境

✅ 推荐组合

  • 使用 Homebrew 管理工具（如 pyenv、nvm、node）
  • 使用 pyenv 管理 Python 版本，用 venv 管理项目依赖隔离
  • 使用 nvm 管理 Node 版本，用 npm/pnpm/yarn 管理 JS 依赖

祝你开发顺利！