极客前沿

Python 环境管理入门:用 pylock.toml 锁定依赖

2026-07-23 01:32
Real Python
查看原文

学会使用 PEP 751 的 pylock.toml 文件,轻松锁定项目依赖,确保每次安装结果一致。

准备环境

在开始之前,你需要安装 Python(一种编程语言,用来运行代码)。建议使用 Python 3.8 以上版本。另外,确保你的 pip(Python 的包安装工具,用来安装别人写好的代码库)版本在 25.1 或更新。如果版本不够,可以运行 pip install --upgrade pip 升级。

Tutorial Image

安装步骤

我们先创建一个 requirements.txt 文件,里面只写你项目直接需要的包。比如你要用 pandas 和 scipy,就写:

Tutorial Image
  • pandas
  • scipy

然后,在命令行中进入这个文件所在的文件夹,运行:

Tutorial Image
  1. pip lock --output pylock.toml —— 这个命令会根据 requirements.txt 生成一个 pylock.toml 文件(一种标准格式的锁文件,记录所有依赖的精确版本)。
  2. 等待解析完成,你会看到一个 pylock.toml 文件出现在目录中。

注意:如果出现网络错误,可能是你的网络环境需要配置代理,或者换个镜像源(比如阿里云镜像)。

Tutorial Image

验证是否成功

打开生成的 pylock.toml 文件,你会看到类似下面的内容:

  • 一个 [metadata] 部分,记录了生成时间和工具信息。
  • 多个 [[package]] 部分,每个都写明了包名、版本、依赖关系等。

为了确认锁文件有效,你可以用以下命令安装:

  1. pip install --lock pylock.toml —— 这会严格按照锁文件安装所有包。
  2. 如果安装成功,表示一切正常。

下一步可以做什么

你可以把 pylock.toml 文件分享给队友,或者放在 CI/CD 流程中,确保每个人、每次运行都使用完全相同的依赖版本。另外,你还可以用其他工具(如 uv、pdm)读取这个锁文件,实现跨工具兼容。

内容来源

Real Python

发布时间

2026-07-23 01:32

返回 AI技术