🔧 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