🐍 Python 开发者在 Mac 上的实践配置

5 阅读1分钟

🔧 1. 安装 Homebrew

如果你还没安装:

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

基本开发工具:

brew install git wget tree tmux zsh neovim

⭐ 2. Python 版本管理:pyenv(最推荐)

安装 pyenv

brew install pyenv

配置到 zsh

~/.zshrc 添加:

export PYENV_ROOT="$HOME/.pyenv"
eval "$(pyenv init -)"

重启终端。

安装 Python(推荐 LTS 版本)

pyenv install 3.12
pyenv global 3.12

查看版本:

python --version

⭐ 3. Python 虚拟环境管理

你有两种最佳选择:

方案 A:pyenv + venv(官方、最轻量)

每次创建项目:

python -m venv .venv
source .venv/bin/activate

停用:

deactivate

方案 B:pipx(全局命令工具)

安装 pipx:

brew install pipx
pipx ensurepath

安装常用工具:

pipx install poetry
pipx install httpie
pipx install jupyterlab

⭐ 4. 基于 Poetry 的依赖管理(超推荐)

Poetry 是现代 Python 项目最佳工具(比 pip + venv 更专业)。

安装

pipx install poetry

创建项目

poetry new my_project
cd my_project
poetry install

常用命令

poetry add requests
poetry remove numpy
poetry run python main.py
poetry shell

⭐ 5. Typing / 格式化 / Lint 全套(企业级标准)

你的 Python 项目建议启用以下工具,提升可维护性:

一行命令安装格式化工具:

pipx install black
pipx install ruff
pipx install mypy
pipx install pyright

推荐 workflow:

  • black:代码风格自动格式化
  • ruff:替代 flake8/isort 的超快 lint 工具
  • mypy:静态类型检查
  • pyright:补充 mypy,更好与 VSCode 集成

.pre-commit-config.yaml 示例:

repos:
  - repo: https://github.com/psf/black
    rev: 24.2.0
    hooks:
      - id: black

  - repo: https://github.com/charliermarsh/ruff-pre-commit
    rev: v0.3.0
    hooks:
      - id: ruff

  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.9.0
    hooks:
      - id: mypy

初始化 pre-commit:

pip install pre-commit
pre-commit install

⭐ 6. VS Code or PyCharm 终极配置

VS Code 推荐插件

  • Python
  • Pylance(智能提示)
  • Ruff
  • Jupyter
  • Black Formatter
  • GitLens
  • Better TOML(用于 Poetry 的 pyproject.toml)
  • Docker & Dev Containers

VS Code settings.json 推荐配置:

{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "ruff.enable": true,
  "editor.defaultFormatter": "ms-python.black-formatter",
  "python.languageServer": "Pylance"
}

⭐ 7. JupyterLab & 数据科学环境

安装:

pipx install jupyterlab

常用包:

poetry add numpy pandas matplotlib seaborn

启动:

jupyter lab

⭐ 8. HTTP / 抓包 / 调试工具

网络抓包:

  • Proxyman(推荐)
  • Charles

API 调试:

  • Insomnia / Postman

安装 uv:

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

⭐ 9. 终端增强

推荐 iTerm2 + Zsh 插件:

brew install zsh-autosuggestions zsh-syntax-highlighting

推荐 Starship 主题:

brew install starship
echo 'eval "$(starship init zsh)"' >> ~/.zshrc

⭐ 10. 最终一键装所有 Python 工具(可直接复制)

brew install pyenv pipx zsh-autosuggestions zsh-syntax-highlighting starship
pipx install poetry
pipx install black
pipx install ruff
pipx install mypy
pipx install pyright
pipx install httpie
pipx install jupyterlab