02 · 环境搭建：uv 包管理与现代 IDE

本篇带你在自己的电脑上装好 Python 环境，学会用现代包管理工具 uv 管理项目和依赖，并在 VS Code 里跑出第一行代码。读完你就能开始写真正的 Python 程序了。

1. 为什么环境搭建是第一步

写代码之前，你的电脑需要「认识 Python」------即装好解释器，让你写的 .py 文件能被运行。但光装解释器还不够：真实项目往往依赖各种第三方库，不同项目对库的版本要求还不一样，直接全局乱装会导致「A 项目能跑、B 项目崩了」的混乱。所以还需要包管理器 和虚拟环境来隔离每个项目。

2. 什么是包管理器、虚拟环境

包管理器 ：帮你下载、安装、升级、删除第三方库（也叫「包/依赖」）的工具。Python 最经典的是 pip，此外还有 conda、poetry 等。
虚拟环境（virtual environment）：为单个项目创建的一个「隔离的 Python 环境」，里面装什么库都影响不到其他项目，互不干扰。这是 Python 工程化的基本操作。

💡 提示：想象你的电脑是一个大仓库，虚拟环境就是给每个项目单独分的小房间，房间里的货架（库）互不串门，想清空就整个房间搬走。

3. 为什么 2026 年推荐 uv

uv 是 2024 年由 Astral 团队（Ruff 的作者）推出的、用 Rust 写的超快 Python 包管理与项目管理工具，到 2026 年已经成为社区公认的现代首选。对比一下：

工具	定位	特点
`pip`	纯包安装器	经典但只管装包，不管理虚拟环境和项目
`conda`	包 + 环境管理	生态大，但体积大、较慢，偏数据科学
`poetry`	依赖 + 打包管理	功能全，但速度一般
`uv`	一站式 + 极速	安装快、能管 Python 版本和虚拟环境、兼容 pip

uv 一个工具能干好几件事：装 Python 本身、创建虚拟环境、装依赖、跑脚本，而且速度比 pip 快一个数量级。本系列统一用 uv。

💻 转行速览 ：用过 Node 的话，uv 类似 npm + nvm 的组合；用过 Rust 会觉得它和 cargo 的体验很像。

4. 安装 Python 3.12+

方式一：官方安装器（推荐新手）

打开 python.org/downloads，下载最新 3.12+ 版本的安装包。
Windows 上安装时务必勾选「Add Python to PATH」；macOS 直接拖拽安装。
安装完成后验证：

bash 复制代码

python --version
# 输出：Python 3.12.x（或更高的 3.13.x）

方式二：用 uv 直接装 Python（省事）

uv 可以像 nvm 管 Node 一样管理 Python 版本，装好 uv 后一条命令即可：

bash 复制代码

uv python install 3.12

5. 安装 uv

macOS / Linux（用官方安装脚本）：

bash 复制代码

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

Windows（用 PowerShell）：

powershell 复制代码

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装后重新打开终端，验证：

bash 复制代码

uv --version
# 输出：uv 0.x.x（版本号以你安装的为准）

6. 用 uv 创建项目与虚拟环境

在终端进入你想放代码的目录，执行：

bash 复制代码

# 初始化项目，自动创建虚拟环境和 pyproject.toml
uv init my-first-project
cd my-first-project

# 创建虚拟环境（若上一步未自动创建）
uv venv

⚠️ 注意：uv venv 默认在当前目录创建 .venv 文件夹，这就是你的虚拟环境。以后装库都用 uv 命令，不要直接 pip install 到全局。

常用命令一览（全部真实存在）：

bash 复制代码

uv python install 3.12   # 安装指定版本的 Python
uv venv                  # 创建虚拟环境
uv pip install requests  # 在虚拟环境里安装库（等价于激活后的 pip）
uv add requests          # 安装库并写入 pyproject.toml（推荐）
uv run python main.py    # 直接用虚拟环境运行脚本，无需手动激活
uv sync                  # 按 pyproject.toml 装齐所有依赖

7. 安装 VS Code 并配置 Python

到 code.visualstudio.com 下载安装 VS Code。
打开扩展面板（Ctrl/Cmd + Shift + X），搜索安装 Python 官方插件（作者 Microsoft）。
打开项目文件夹，按 Ctrl/Cmd + Shift + P 输入 Python: Select Interpreter，选择 .venv 里的解释器。
此时写代码会有自动补全、错误提示、一键运行。

<图：VS Code 中通过「Select Interpreter」选择 .venv 虚拟环境解释器的截图>

8. 实战：跑出第一行 Hello World

在项目里新建 main.py，输入：

python 复制代码

# main.py
print("Hello, Python!")

在 VS Code 里点击右上角的运行按钮（▶），或终端执行：

bash 复制代码

uv run python main.py

text 复制代码

# 输出：
Hello, Python!

看到这行输出，说明你的环境已经彻底打通。接下来可以进入真正的语法学习了。

9. 常见错误与避坑

python 命令不存在 / 提示不是内部命令 ：Windows 安装时没勾「Add Python to PATH」。重装勾选，或用 uv python install 后用 uv run 代替裸 python。
uv 命令找不到：装完没重启终端，PATH 没刷新。关掉终端重开一次。
在虚拟环境外乱装库 ：务必先 uv init / uv venv，再用 uv pip install 或 uv add，别全局污染。
分不清 uv pip install 和 uv add ：前者只装库不记录，后者额外写入 pyproject.toml 便于复现。项目里优先用 uv add。

10. 小结

环境 = 解释器 + 包管理器 + 虚拟环境三者配合。
uv 是 2026 年最推荐的现代工具，一个命令管版本、环境、依赖。
VS Code 装 Python 插件并选对 .venv 解释器，开发体验起飞。
uv run python main.py 是以后跑代码的默认姿势。

11. 练习与思考

用 uv 初始化一个项目，安装 requests，再执行 uv sync 观察发生了什么。
试着不激活虚拟环境，直接用 uv run python -c "print('hi')" 跑一行代码，理解 uv run 的作用。
思考：为什么同一个项目在两台电脑上要能「一键复现环境」，pyproject.toml 起了什么作用？

12. 延伸阅读

uv 官方文档
Python 官方下载页
下一篇：《03 · 变量、数据类型与运算符》将正式开始写 Python 代码。

📚 本系列导航

上一篇 ：《01 · Python 全景：为什么 2026 年它仍最值得学》
下一篇 ：《03 · 变量、数据类型与运算符》
系列总览 ：《Python 从入门到精通》系列目录

如果觉得有用，欢迎收藏、点赞、转发，让更多人少走弯路。