跳转至

快速设置 uv 默认源为国内镜像

1. 修改 pyproject.toml

项目目录
1
2
3
4
5
6
7
uv-doc-zh/
├── README.md
├── docs
├── index.py
├── mkdocs.yml
├── pyproject.toml
└── uv.lock

2. 快速设置（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "tencent"
url = "https://mirrors.cloud.tencent.com/pypi/simple/"
#url = "https://mirrors.tencentyun.com/pypi/simple/" # 内网

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "aliyun"
url = "https://mirrors.aliyun.com/pypi/simple/"
#url = "http://mirrors.cloud.aliyuncs.com/pypi/simple/" # 内网

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "volces"
url = "https://mirrors.volces.com/pypi/simple/"
#url = "https://mirrors.ivolces.com/pypi/simple/" # 内网

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "huaweicloud"
url = "https://mirrors.huaweicloud.com/repository/pypi/simple/"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "tuna"
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "ustc"
url = "https://pypi.mirrors.ustc.edu.cn/simple/"

3. 设置参数说明

3.1. index

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "名称"
url = "<镜像源地址>"

按 顺序 决定优先级

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[[tool.uv.index]]
name = "名称1"
url = "<镜像源地址 1>"

[[tool.uv.index]]
name = "名称2"
url = "<镜像源地址 2>"

3.2. index-url

已弃用。但版本 (0.7.20) 可用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
[project]
name = "uv-doc-zh"
version = "0.1.0"
description = "一个用 Rust 编写的极其快速的 Python 包和项目管理器。"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "mkdocs-material>=9.6.15",
]

[tool.uv]
index-url = "<替换为你需要的镜像源地址>"

4. 国内镜像源

阿里云
https://mirrors.aliyun.com/pypi/simple/
腾讯云
https://mirrors.cloud.tencent.com/pypi/simple/
火山引擎
https://mirrors.volces.com/pypi/simple/
华为云
https://mirrors.huaweicloud.com/repository/pypi/simple/
清华大学
https://pypi.tuna.tsinghua.edu.cn/simple/
中国科学技术大学
https://pypi.mirrors.ustc.edu.cn/simple/