uv安装使用

uv的功能

uv 是一个用 Rust 编写的、速度极快的 Python 包和项目管理器。 它的目标是提供一个统一、高效的开发工作流程。

它可以方便的把所有的源都放在一个项目目录下，可以方便的进行包的管理。速度比conda快不知多少倍。

uv安装与换源

安装很方便，有两种方法，一种是用pip装，另一种是用命令脚本装。

pip装uv

pip install uv 执行这句就可以了。

命令脚本装uv

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

装完后在命令窗口执行uv --version，如果显示版本号了，就表示安装完成了。

换源

因为uv是用了github的一些资源，而且国外的包资源总是比较慢，体现不出uv的快速。所以要换源。

比较推荐的方法是在用户目录下创建 uv.toml 文件（路径参考）：

1
2
Linux/macOS: ~/.config/uv/uv.toml
Windows: %APPDATA%\uv\uv.toml

编辑文件内容如下：

1
2
3
4
5
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true
# 或使用清华源
# url = "https://pypi.tuna.tsinghua.edu.cn/simple/"

uv的基础用法

uv创建项目文件夹

在命令行中打开某个文件夹，在这个目录下执行uv init <project dir>命令，稍等，就可以在这个文件夹下生成一个目录。示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
cd D:\projects\python
$  uv init myproject
Initialized project `myproject` at `D:\projects\python\myproject`

$  cd .\myproject\

$  ls


    目录: D:\projects\python\myproject


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        2024/12/27  12:06:08            109 .gitignore
-a----        2024/12/27  12:06:08              5 .python-version
-a----        2024/12/27  12:06:08             87 hello.py
-a----        2024/12/27  12:06:08            155 pyproject.toml
-a----        2024/12/27  12:06:08              0 README.md

安装python包

比如安装numpy，可以在这个目录下输入命令uv add numpy，它会自动分析依赖，下载对应的包，而且，速度超快。

安装python

1
2
3
4
5
# 安装 Python 3.12
uv python install 3.12

# 查看所有可用的 Python 版本
uv python list

vscode中使用uv

在vscode中搜索扩展UV Toolkit，安装。

用的时候按ctrl+shift+p，输入uv，就可以看到一些uv相关的用法。

如果是用vscode打开的项目文件夹，是不用额外操作的，直接点运行，它就可以识别这个文件夹中安装的包。

如果这个文件夹中没有uv创建的环境，就需要通过按ctrl+shift+p，输入uv来选择uv的环境了。