uv 环境配置

根据官方文档和常见实践，以下是一个合理且功能完善的 ~/.config/uv/uv.toml 配置文件模板，已修正语法错误并优化常用设置：

# ~/.config/uv/uv.toml
# UV 全局配置文件 (适用于 uv >= 0.6.0)

# ----------------------
# 1. 索引源配置 (加速下载)
# ----------------------
# 使用清华源作为默认索引（国内推荐）
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true  # 设为默认源

# 可选：添加阿里云作为备用源
# [[index]]
# url = "https://mirrors.aliyun.com/pypi/simple/"

# ----------------------
# 2. 网络与安全设置
# ----------------------
native-tls = false  # 禁用系统证书，使用内置证书提升跨平台兼容性
offline = false     # 默认启用网络访问
allow-insecure-host = []  # 禁止不安全连接

# ----------------------
# 3. 缓存与存储优化
# ----------------------
cache-dir = "~/.cache/uv"  # 自定义缓存目录（Linux/macOS 默认位置）
no-cache = false           # 启用缓存加速
# exclude-newer = "2025-12-31"  # 限制安装包的上传时间（避免新版兼容问题）

# ----------------------
# 4. 并发控制
# ----------------------
concurrent-downloads = 8   # 并行下载数（建议为CPU核心数2倍）
concurrent-builds = 4      # 并行编译数（避免OOM）
concurrent-installs = 2    # 并行安装数（机械硬盘建议设为1）

# ----------------------
# 5. Python 环境管理
# ----------------------
python-preference = "managed"  # 优先使用uv管理的Python版本
no-pin-python = false          # 启用.python-version文件生成

# ----------------------
# 6. 高级功能（按需启用）
# ----------------------
# [pip]  # 仅影响`uv pip`命令
# index-strategy = "unsafe-any-match"  # 允许跨索引搜索同名包
# resolution = "highest"  # 默认安装最高版本

⚙️ 关键配置说明

1. 索引源优化
   • 清华源（https://pypi.tuna.tsinghua.edu.cn/simple）显著提升国内下载速度，实测可达 pip 的 10 倍以上。
   • 多源配置时，default = true 标记主源，避免解析冲突。
2. 并发参数调优
   • concurrent-downloads=8：充分利用带宽（需网络稳定）。
   • concurrent-builds=4：平衡编译效率与内存占用（大型包如 NumPy 适用）。
3. Python 版本管理
   • python-preference = "managed" 确保优先使用 uv python install 安装的版本，避免系统环境污染。

🔍 验证配置生效

uv pip install requests -v
# 输出中应出现：Using index-url: https://pypi.tuna.tsinghua.edu.cn/simple

⚠️ 常见问题处理

• 权限错误（Mac/Linux）：

  sudo chmod 755 ~/.config/uv/uv.toml  # 授予写入权限

• 多项目隔离：在项目根目录创建 uv.toml，优先级高于全局配置。

此配置已移除导致解析错误的 tool 层级（原错误：unknown field 'tool'[^用户问题]），语法兼容 uv 最新版本。如需更多选项，参考官方配置文档。