Lychee工具HTTP状态码接受列表参数使用指南

Lychee是一款流行的链接检查工具，在0.14.0版本中对HTTP状态码接受列表(--accept参数)的功能进行了重要改进。本文将详细介绍该参数的正确使用方法及常见问题解决方案。

参数功能解析

--accept参数允许用户指定一组可接受的HTTP状态码范围。当链接返回的状态码在指定范围内时，Lychee不会将其标记为错误。这在某些特殊场景下非常有用，例如：

1. 临时重定向(3xx状态码)
2. 限流响应(429状态码)
3. 服务端错误但可接受(5xx状态码)

正确语法格式

在0.14.0及以上版本中，--accept参数支持以下语法：

1. 单个状态码：--accept "200"
2. 状态码范围：--accept "200..=204"
3. 多值组合：--accept "200..=204, 429, 500"

需要注意的是：

• 必须使用双引号包裹参数值
• 范围表示使用..=语法
• 多个值用逗号分隔

常见问题排查

如果遇到"invalid digit found in string"错误，请检查：

1. 是否使用了单引号而非双引号
2. 范围语法是否正确(使用..=而非其他符号)
3. 参数值中是否包含非法字符

版本兼容性说明

该功能在0.10.1至0.13.0版本中存在解析问题，建议用户升级至0.14.0或更高版本以获得最佳体验。新版本不仅修复了参数解析问题，还改进了错误提示信息，使问题定位更加容易。

实际应用示例

假设我们需要检查一个网站，但希望忽略以下情况：

• 200-204的成功响应
• 429限流响应
• 500服务器错误

可以使用如下命令： lychee --accept "200..=204,429,500" https://example.com

通过合理使用--accept参数，用户可以更灵活地控制链接检查的行为，适应各种复杂的实际场景需求。