告别繁琐的 Python 环境管理！uv 是一款高效、便捷的工具，能一站式解决 Python 版本管理、虚拟环境创建、包管理以及项目管理等问题，速度快，上手简单。本文将以 Windows PowerShell 为例，演示 uv 的使用方法，其他平台可参考官方文档进行相应调整。
安装 uv
uv 不依赖 Python，因此不建议使用 pip 或 pipx 安装。Windows 系统可直接通过 PowerShell 执行以下命令安装：
<code class="language-powershell">powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"</code>
或使用 scoop 等软件包管理器安装：
<code class="language-bash">scoop install uv</code>
使用 uv 管理多版本 Python
使用 uv python list 命令查看可安装和已安装的 Python 版本：
<code class="language-bash"># uv python list cpython-3.13.1+freethreaded-windows-x86_64-none <download available=""> cpython-3.13.1-windows-x86_64-none <download available=""> cpython-3.12.8-windows-x86_64-none <download available=""> ...</code>
安装最新版本：
<code class="language-bash"># uv python install Installed Python 3.13.1 in 5.89s + cpython-3.13.1-windows-x86_64-none</code>
查看安装结果：已安装版本会显示安装路径。
<code class="language-bash"># uv python list cpython-3.13.1-windows-x86_64-none C:\Users\meebo\AppData\Roaming\uv\python\cpython-3.13.1-windows-x86_64-none\python.exe ...</code>
获取 Python 安装路径：
<code class="language-bash"># uv python dir C:\Users\meebo\AppData\Roaming\uv\python</code>
安装指定版本：
<code class="language-bash"># uv python install 3.10 Installed Python 3.10.16 in 9.78s + cpython-3.10.16-windows-x86_64-none</code>
卸载 Python 版本 (需指定版本)：
<code class="language-bash"># uv python uninstall 3.10 Searching for Python versions matching: Python 3.10 Uninstalled Python 3.10.16 in 1.52s - cpython-3.10.16-windows-x86_64-none</code>
查看所有版本 (包含所有修订版本): uv python list --all-versions
安装多个版本：uv python install 3.10 3.11
卸载多个版本：uv python uninstall 3.10 3.11
使用 uv 替代 python/pip 工具
uv 管理的 Python 环境不能直接用 python 命令执行，需通过 uv run 命令执行。例如：
<code class="language-python"># cat .\show_version.py import sys print(sys.version)</code>
执行：
<code class="language-bash"># uv run .\show_version.py 3.13.1 (main, Dec 19 2024, 14:38:48) [MSC v.1942 64 bit (AMD64)]</code>
指定 Python 版本执行：uv run --python 3.10 .show_version.py
从标准输入执行：echo 'print("hello world!")' | uv run -
查看已安装的 Python 版本：uv python list --only-installed
设置默认 Python 版本 (仅限当前目录)：uv python pin 3.10 (创建 .python-version 文件)
指定执行时需要的包
如果程序需要额外包，例如 cowsay：
<code class="language-python"># cat .\cow.py
from cowsay import cow
cow('hello, world')</code>使用 --with 选项指定包：
<code class="language-bash"># uv run --with cowsay .\cow.py Installed 1 package in 13ms ...</code>
清除缓存的虚拟环境：uv cache clean
管理虚拟环境
创建虚拟环境：uv venv --python 3.10 (创建 .venv 目录) 或指定目录名: uv venv myenv
使用指定虚拟环境：uv run --python myenv .show_version.py
删除虚拟环境：删除虚拟环境目录
管理包
使用 uv pip 命令管理包，它与 pip 命令兼容。
安装包：uv pip install cowsay
查看包依赖关系：uv pip tree
卸载包：uv pip uninstall rich (不会自动删除不再需要的依赖包)
使用 uv 管理 Python 项目
uv 提供两种项目管理方式：单文件项目和文件夹项目。
单文件项目
初始化单文件项目：uv init --script cow3.py --python 3.13 (在 cow3.py 文件中添加元数据)
添加包：uv add --script cow3.py cowsay rich (修改 cow3.py 文件元数据)
移除包：uv remove --script cow3.py rich (修改 cow3.py 文件元数据)
文件夹项目
初始化文件夹项目：uv init myproject (创建项目目录，包含 .gitignore, .python-version, hello.py, pyproject.toml, README.md)
执行项目：uv run hello.py (创建 .venv 虚拟环境)
添加包：uv add cowsay rich (修改 pyproject.toml 文件)
更新包：uv lock --upgrade-package cowsay 或 uv lock --upgrade
移除包：uv remove cowsay
同步项目环境与 uv.lock 文件：uv sync
查看项目包依赖关系：uv tree
使用包提供的工具命令
直接执行包命令：uvx cowsay -t 'hello, uv' 或 uv tool run cowsay -t 'hello, uv'
指定包执行命令：uvx --from httpie http -p=b GET https://flagtech.github.io/flag.txt
安装包命令到系统：uv tool install httpie
更新包命令：uv tool upgrade httpie
卸载包命令：uv tool uninstall httpie
uv 提供了高效便捷的 Python 环境管理方案，显著提升开发效率。 通过本文的介绍，相信您已经掌握了 uv 的基本使用方法，可以更好地管理您的 Python 项目和环境。
以上是使用 uv 管理 Python 环境的详细内容。更多信息请关注PHP中文网其他相关文章！
