前言
作为前端工程师，你对"配环境"这件事早就免疫了——装 Node、配 nvm、建项目、装依赖，这套流程已经刻进肌肉记忆。
好消息是：Python 的工具链和前端几乎一一对应，你不需要从零理解，只需要完成一次认知映射。
工具链对照表
| 前端（JS 生态） | Python 生态 | 作用 |
|---|---|---|
| Node.js | Python 解释器 | 运行时 |
| nvm | pyenv / conda | 版本管理 |
| npm / yarn / pnpm | pip / poetry / uv | 包管理器 |
| package.json | pyproject.toml / requirements.txt | 依赖声明 |
| node_modules | venv（虚拟环境） | 依赖隔离 |
| npx | pipx | 临时运行工具 |
| .nvmrc | .python-version | 版本锁定文件 |
看完这张表，你应该已经没有陌生感了。
安装 Python
推荐通过 pyenv 管理 Python 版本，就像用 nvm 管理 Node 一样。
macOS / Linux：
1# 安装 pyenv（类比安装 nvm）
2curl https://pyenv.run | bash
3
4# 安装 Python 3.12（类比 nvm install 20）
5pyenv install 3.12
6
7# 设置全局版本（类比 nvm alias default）
8pyenv global 3.12
9
10# 验证
11python --version # Python 3.12.x
Windows：
直接去 python.org 下载安装包，安装时勾选 "Add Python to PATH"，或者使用 winget install Python.Python.3.12。
虚拟环境：Python 的 node_modules 隔离
前端项目每个目录都有自己的 node_modules，Python 通过虚拟环境实现同样的依赖隔离。
1# 进入项目目录
2cd my-project
3
4# 创建虚拟环境（类比 npm init，但隔离的是 Python 本身）
5python -m venv .venv
6
7# 激活虚拟环境
8# macOS / Linux：
9source .venv/bin/activate
10
11# Windows：
12.venv\Scripts\activate
13
14# 激活后，命令行前缀会变成 (.venv)
15# 安装依赖（类比 npm install）
16pip install requests
17
18# 导出依赖列表（类比 package.json 里的 dependencies）
19pip freeze > requirements.txt
20
21# 别人拿到项目后安装（类比 npm install）
22pip install -r requirements.txt
💡 现代替代方案：推荐使用 uv，它是 Rust 写的 pip 替代品，速度极快，语法与 pip 几乎一致，且自动管理虚拟环境。
uv之于 Python，就像pnpm之于 npm。
VS Code 配置
安装以下插件，打造与前端开发体验一致的 Python 工作流：
| 插件名 | 作用 | 前端类比 |
|---|---|---|
| Python (ms-python) | 基础支持 | ESLint 基础插件 |
| Pylance | 智能提示、类型检查 | TypeScript Language Server |
| Black Formatter | 代码格式化 | Prettier |
| isort | import 语句排序 | ESLint import 插件 |
| Jupyter | 运行 .ipynb 文件 | 无对应（新能力） |
在项目根目录创建 .vscode/settings.json：
1{
2 "python.defaultInterpreterPath": ".venv/bin/python",
3 "editor.formatOnSave": true,
4 "[python]": {
5 "editor.defaultFormatter": "ms-python.black-formatter"
6 }
7}
这和你的前端 .vscode/settings.json 配置 Prettier 一模一样的思路。
第一个 Python 脚本
1# hello.py
2
3name = "前端工程师"
4languages = ["JavaScript", "TypeScript", "Python"]
5
6print(f"你好，{name}！")
7print(f"你已经会：{', '.join(languages[:-1])}")
8print(f"正在学习：{languages[-1]} 🐍")
运行：
1python hello.py
2# 你好，前端工程师！
3# 你已经会：JavaScript, TypeScript
4# 正在学习：Python 🐍
小结
- Python 工具链与前端高度对应，认知成本极低
- 用
pyenv管虚拟环境，用venv隔离项目依赖 - VS Code 配置完毕后，开发体验与写 TS 无异
- 下一篇：语法速览，你会发现自己已经会 80%