Python 环境管理入门:用 pylock.toml 锁定依赖
学会使用 PEP 751 的 pylock.toml 文件,轻松锁定项目依赖,确保每次安装结果一致。
准备环境
在开始之前,你需要安装 Python(一种编程语言,用来运行代码)。建议使用 Python 3.8 以上版本。另外,确保你的 pip(Python 的包安装工具,用来安装别人写好的代码库)版本在 25.1 或更新。如果版本不够,可以运行 pip install --upgrade pip 升级。
安装步骤
我们先创建一个 requirements.txt 文件,里面只写你项目直接需要的包。比如你要用 pandas 和 scipy,就写:
- pandas
- scipy
然后,在命令行中进入这个文件所在的文件夹,运行:
pip lock --output pylock.toml—— 这个命令会根据 requirements.txt 生成一个 pylock.toml 文件(一种标准格式的锁文件,记录所有依赖的精确版本)。- 等待解析完成,你会看到一个 pylock.toml 文件出现在目录中。
注意:如果出现网络错误,可能是你的网络环境需要配置代理,或者换个镜像源(比如阿里云镜像)。
验证是否成功
打开生成的 pylock.toml 文件,你会看到类似下面的内容:
- 一个 [metadata] 部分,记录了生成时间和工具信息。
- 多个 [[package]] 部分,每个都写明了包名、版本、依赖关系等。
为了确认锁文件有效,你可以用以下命令安装:
pip install --lock pylock.toml—— 这会严格按照锁文件安装所有包。- 如果安装成功,表示一切正常。
下一步可以做什么
你可以把 pylock.toml 文件分享给队友,或者放在 CI/CD 流程中,确保每个人、每次运行都使用完全相同的依赖版本。另外,你还可以用其他工具(如 uv、pdm)读取这个锁文件,实现跨工具兼容。
内容来源
Real Python
发布时间
2026-07-23 01:32