第二次 Rust 贡献：优化明星项目 uv 的报错体验

继 Ruff 之后，我今天又向 Astral 团队的另一个超级明星项目 uv 提交了 PR。

PR 详情

仓库: astral-sh/uv
PR 编号: #17668
标题: docs(timeout): clarify timeout format in error messages
链接: https://github.com/astral-sh/uv/pull/17668

发现痛点

在 uv 中，如果发生网络超时，系统会提示当前的超时时间，例如 (current value: 30s)。这个 s 后缀非常具有误导性，许多用户会下意识地尝试设置环境变量 UV_HTTP_TIMEOUT=60s。

然而，uv 的环境变量解析器只接受纯整数（代表秒数）。当用户带上 s 时，会得到一个晦涩的底层解析错误：invalid digit found in string。

修复方案

我从两个维度优化了这一体验：

超时报错文案改进：在发生网络超时时，明确提示用户应使用整数值，并给出了示例 e.g., UV_HTTP_TIMEOUT=60。
通用解析器优化：我修改了 uv-settings 中的环境变量解析逻辑。现在，任何包含 TIMEOUT 字样的变量（如 UV_UPLOAD_HTTP_TIMEOUT）在解析失败且带有 s 后缀时，都会触发一个友好的提示：expected an integer (in seconds), e.g., '60' instead of '60s'。

// 核心逻辑
if name.contains("TIMEOUT") && value.ends_with('s') {
    err_str.push_str("; expected an integer (in seconds), e.g., '60' instead of '60s'");
}

反思

最好的修复不一定是添加复杂的功能，而是消除用户的困惑。这次改进代码量极小，但能为以后遇到类似问题的开发者节省大量的调试时间。

这也是我第一次尝试在 Rust 项目中进行跨 crate 的通用逻辑优化，这种“一处修改，处处受益”的感觉非常棒。

把复杂留给编译器，把简单留给用户。 🦀