4 pip 接口 on 编程那些事儿

4.1 使用环境

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/environments/

4.1 使用环境

每个 Python 安装都有一个在使用 Python 时激活的环境。可以把包安装到某个环境中，使它们的模块可以从你的 Python 脚本中使用。通常认为，最好不要修改 Python 安装的环境。对随操作系统提供的 Python 安装来说尤其重要，它们往往自行管理包。虚拟环境是一种轻量的方式，用于把包与 Python 安装的环境隔离。与 pip 不同，uv 默认要求使用虚拟环境。

4.2 管理包

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/packages/

4.2 管理包

安装包

要把包安装到虚拟环境中，例如 Flask：

1

$ uv pip install flask

要安装启用了可选依赖的包，例如带 “dotenv” extra 的 Flask：

1

$ uv pip install "flask[dotenv]"

要安装多个包，例如 Flask 和 Ruff：

4.3 检查环境

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/inspection/

4.3 检查环境

列出已安装的包

列出环境中的所有包：

1

$ uv pip list

以 JSON 格式列出包：

1

$ uv pip list --format json

以 requirements.txt 格式列出环境中的所有包：

1

$ uv pip freeze

检查某个包

要显示已安装包的信息，例如 numpy：

4.4 声明依赖

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/dependencies/

4.4 声明依赖

最佳实践是在静态文件中声明依赖，而不是通过临时安装来修改环境。依赖定义好之后，可以锁定它们，以创建一致且可复现的环境。

使用 `pyproject.toml`

pyproject.toml 文件是定义项目配置的 Python 标准。

要在 pyproject.toml 文件中定义项目依赖：

4.5 锁定环境

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/compile/

4.5 锁定环境

锁定就是把某个依赖（例如 ruff）要使用的确切版本写入文件。处理大量依赖时，锁定确切版本很有用，这样可以复现环境。不锁定的话，依赖版本可能随着时间推移、使用不同工具或跨平台而发生变化。

4.6 与 pip 和 pip-tools 的兼容性

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/pip/compatibility/

4.6 与 pip 和 pip-tools 的兼容性

uv 被设计为常用 pip 和 pip-tools 工作流的即插即用替代品。

非正式地说，其意图是让现有的 pip 和 pip-tools 用户无需对打包工作流做实质性改动即可切换到 uv；在大多数情况下，把 pip install 换成 uv pip install 应“直接可用”。

4 pip 接口 on 编程那些事儿

4.1 使用环境

4.1 使用环境

4.2 管理包

4.2 管理包

安装包

4.3 检查环境

4.3 检查环境

列出已安装的包

检查某个包

4.4 声明依赖

4.4 声明依赖

使用 pyproject.toml

4.5 锁定环境

4.5 锁定环境

4.6 与 pip 和 pip-tools 的兼容性

4.6 与 pip 和 pip-tools 的兼容性

使用 `pyproject.toml`