python环境管理工具-uv-custom

uv-custom 是一个镜像项目，它与官方 uv 保持同步，但提供了更适合国内用户的安装和配置。

安装命令：你可以通过以下一键命令安装。该脚本会自动从国内镜像下载 uv，并为你配置好清华大学的 PyPI 镜像源。

macOS / Linux:

curl -LsSf https://gitee.com/jumploop/uv-custom/releases/download/latest/uv-installer-custom.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://gitee.com/jumploop/uv-custom/releases/download/latest/uv-installer-custom.ps1 | iex"

如果你更倾向于使用官方 uv，手动配置镜像源也非常简单。

通过配置文件设置（永久生效）

在系统指定位置创建 uv.toml配置文件是推荐的方式。
- 用户级配置（仅当前用户生效）：
  - 创建配置文件所在的目录：mkdir -p ~/.config/uv
  - 创建并编辑配置文件，例如在 Linux/macOS 上可以运行：
```
cat > ~/.config/uv/uv.toml << EOF
[registry-index]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"
EOF
```
通过环境变量设置（临时生效）

你也可以在每次使用 uv 前，通过设置环境变量来指定镜像源。
- macOS / Linux:
```
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
```
- Windows (PowerShell):
```
$env:UV
```

uv-custom 是一个专为国内用户优化的 uv工具定制版本，能显著提升 Python 包管理速度。下面这个表格汇总了它的核心用法，帮助你快速上手。

功能	命令/操作	说明
安装 uv-custom	`curl -LsSf ... \| sh`(macOS/Linux) 或 `powershell -c "irm ... \| iex"`(Windows)	从国内镜像一键安装
创建环境 (默认)	`uv venv`	在当前目录创建名为 `.venv`的虚拟环境
创建环境 (指定路径)	`uv venv myenv`或 `uv venv /path/to/env`	在指定名称或路径创建虚拟环境
指定Python版本	`uv venv --python 3.11`	创建时指定Python版本，若未安装会自动下载
激活环境 (macOS/Linux)	`source .venv/bin/activate`	激活当前目录下的默认虚拟环境
激活环境 (Windows PowerShell)	`.venv\Scripts\Activate.ps1`	在Windows PowerShell中激活虚拟环境
停用环境	`deactivate`	退出当前虚拟环境

不激活环境直接运行命令

你可以不激活虚拟环境，而使用 uv run直接在虚拟环境中执行特定命令，这尤其在脚本编写时很有用。
```
# 假设虚拟环境在项目根目录的 .venv 文件夹下
uv run python script.py
```
配置国内镜像源加速

为了获得最佳下载速度，建议配置国内镜像源。除了安装脚本可能自动配置的清华大学镜像，你还可以在项目目录下的 pyproject.toml文件中永久设置：
```
# 在 pyproject.toml 中添加
[[tool.uv.index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
```
或者通过环境变量临时指定：
```
export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
uv add requests
```

目录指定：创建虚拟环境时，可以但不必须指定目录。不指定则默认在当前目录创建 .venv。
核心优势：uv-custom通过国内镜像加速，解决了官方 uv在国内网络环境下可能遇到的下载慢问题，让你既能享受 uv的速度，又能稳定下载。
工作流：基本流程是安装 uv-custom-> 创建虚拟环境（可选择是否指定目录和Python版本）-> 激活环境使用。