Python 包与项目管理工具——uv

Python 的环境管理方案很多，常见的有：

本文选择 uv 作为项目管理工具。

uv 的官方文档：uv

第三方中文文档：uv 中文文档

uv 的优点很多，最直观的一点是快：依赖解析和安装速度明显优于传统方案，同时也能很好地兼容 Python 生态。后面我们会用它来创建项目、管理依赖、维护虚拟环境。

安装方式可以参考官方文档：安装 | uv 中文文档

最简单的方式是直接用 pip 安装：

复制代码

pip install uv

安装完成后，可以在终端中执行：

复制代码

uv --version

如果能正常输出版本号，就说明安装成功。

默认情况下，uv 会从国外源下载依赖，速度通常比较慢。推荐把下载源改成国内镜像站点。

uv 支持两种配置方式：

这里采用系统级配置。

Windows 系统，在 CMD 中运行：

复制代码

setx UV_DEFAULT_INDEX "https://pypi.tuna.tsinghua.edu.cn/simple"

设置完成后，重新打开终端即可生效。

macOS 或 Linux 系统：

复制代码

echo 'export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple' >> ~/.zshrc && source ~/.zshrc

如果你使用的是 bash，可以把 ~/.zshrc 换成 ~/.bashrc。

常见的国内镜像站点如下，可以根据网络情况选择：

接下来创建一个实际项目。开发工具使用 PyCharm ，项目管理使用 uv。

第一步，打开 PyCharm，新建一个 Project。在解释器配置中选择 uv，让 PyCharm 使用 uv 来管理项目环境。

项目创建完成后，还需要引入 Jupyter Notebook 依赖。后续课程中会大量使用 Notebook 来演示代码。

在 PyCharm 左侧点击 Terminal 按钮，打开终端，输入：

复制代码

uv add notebook

这条命令会把 notebook 加入项目依赖，并自动完成安装。

环境准备好后，创建一个 Notebook 来测试。

在项目中新建一个 Jupyter Notebook 文件，命名为 hello.ipynb。

然后在代码单元格中输入：

复制代码

print("Hello World")

按快捷键 SHIFT + ENTER 运行。

如果下方正确输出：

复制代码

Hello World

说明 uv、PyCharm、Jupyter 以及项目依赖都已经配置成功，开发环境可以正常使用了。

本节完成了开发环境的搭建：