使用 uv 运行 python 脚本文件,最直接的方法是使用 uv run 命令。该命令会自动处理虚拟环境的创建、依赖的安装以及脚本的执行,确保代码在隔离且一致的环境中运行。

如何指定特定的 Python 版本来运行脚本
可以通过在 uv run 命令后添加 --python 参数并指定版本号,强制 uv 使用指定的 Python 解释器执行脚本。例如,使用 --python 3.10 可以确保即使系统安装了其他版本,也会优先使用 Python 3.10 来运行当前脚本。

如何在运行前自动安装脚本所需的依赖包
uv run 默认会检查当前目录下的 pyproject.toml 或 requirements.txt 文件。如果存在这些文件,它会在运行脚本前自动解析并安装其中列出的所有依赖项。若未找到这些文件,则不会安装任何额外依赖,仅使用已安装的包或标准库。
立即学习“Python免费学习笔记(深入)”;

基于 pyproject.toml 中声明的依赖运行脚本的具体行为
当项目中存在 pyproject.toml 时,uv 会读取其中的 dependencies 字段。如果脚本运行时需要某个未在 pyproject.toml 中声明但在代码中导入的包,uv 不会自动安装它,而是直接抛出 ModuleNotFoundError。这种行为确保了环境的一致性,避免了隐式依赖带来的问题。
import sys print(sys.version)
[project]
name = "my-script"
version = "0.1.0"
dependencies = [
"requests",
]
uv run my_script.py
Python 3.10.12


















