在python中使用uv配置全局参数，最直接的方法是在项目根目录或用户主目录下创建并编辑`.python-version`文件来锁定版本，或者通过环境变量和配置文件调整行为。对于需要持久化的全局设置，推荐在`~/.config/uv/uv.toml`中定义默认工具链、索引源或缓存路径，这样所有基于uv的命令都会自动应用这些配置。
如何指定全局Python解释器版本
要确保所有新项目或现有项目使用特定的Python版本，可以在用户主目录创建`.python-version`文件。该文件只需包含版本号，如`3.12`，uv会自动下载并使用该版本作为默认解释器。这种方式比手动安装更可靠，因为uv会管理解释器的生命周期。
mkdir -p ~/.config/uv echo '3.12' > ~/.config/uv/.python-version uv run python --version
上述命令创建了配置目录并写入版本要求。执行`uv run`时，若本地未安装3.12，uv将自动下载。验证结果可通过`--version`输出确认。注意，此配置仅影响后续新初始化的项目或未显式指定版本的项目。
立即学习“Python免费学习笔记（深入）”；
如何自定义全局索引源与缓存路径
当需要切换PyPI镜像或更改缓存位置以提升下载速度或节省磁盘空间，可在`uv.toml`中配置`index`和`cache-dir`。例如，设置国内镜像源可显著加快依赖解析。同时，指定`cache-dir`可将缓存移至SSD或其他高速存储。
[[index]] name = "aliyun" p-url = "https://mirrors.aliyun.com/pypi/simple/" cache-dir = "/data/uv-cache"
这段配置定义了名为`aliyun`的索引源，其简单URL指向阿里云镜像。`cache-dir`指定了缓存存放路径。保存后，所有uv命令将优先从该镜像拉取包，并将数据存入指定目录。若需临时覆盖，可使用`--index-url`参数，但全局配置更为便捷。
基于uv.toml中cache-dir配置的具体问题：缓存清理策略是什么
当设置了自定义`cache-dir`后，用户常关心如何清理过期或无用缓存。uv提供了`uv cache clean`命令，可清除整个缓存或按包名清理。由于缓存结构由uv内部管理，直接删除文件夹可能导致不一致，因此必须使用官方命令。此外，定期运行`uv cache clean`有助于释放空间，特别是在频繁切换项目依赖时。
