Rust 语言指南¶

linthis 使用 clippy 进行代码检查，使用 rustfmt 进行代码格式化。

支持的文件扩展名¶

.rs

必需工具¶

代码检查：clippy¶

# 通过 rustup 安装（推荐）
rustup component add clippy

# 验证安装
cargo clippy --version

格式化：rustfmt¶

# 通过 rustup 安装（推荐）
rustup component add rustfmt

# 验证安装
rustfmt --version

配置¶

基本示例¶

# .linthis/config.toml

[rust]
max_complexity = 15
excludes = ["target/**"]

禁用特定 Clippy 检查¶

[rust.rules]
disable = [
    "clippy::needless_return",
    "clippy::too_many_arguments",
    "clippy::type_complexity"
]

更改严重性¶

[rust.rules.severity]
"clippy::unwrap_used" = "error"    # 将 unwrap 视为错误
"clippy::todo" = "warning"         # 保持 TODO 为警告

自定义规则¶

[[rules.custom]]
code = "rust/no-println"
pattern = "println!"
message = "Use log macros instead of println!"
severity = "warning"
suggestion = "Use log::info!, log::debug!, etc."
languages = ["rust"]

CLI 用法¶

# 仅检查 Rust 文件
linthis -c --lang rust

# 仅格式化 Rust 文件
linthis -f --lang rust

# 检查特定文件
linthis -c src/main.rs

Clippy 配置¶

linthis 会使用您的 .clippy.toml 或 clippy.toml 配置文件：

# clippy.toml
cognitive-complexity-threshold = 15
too-many-arguments-threshold = 8

常见问题¶

Clippy 未找到¶

Warning: No rust linter available for rust files
  Install: rustup component add clippy

解决方案：运行 rustup component add clippy

首次运行缓慢¶

Clippy 首次运行时会编译您的项目。后续运行使用增量编译。

与项目 clippy 配置冲突¶

linthis 使用与 cargo clippy 相同的配置。您项目的 clippy.toml 设置会被尊重。

最佳实践¶

使用工作空间级配置：将 .linthis/config.toml 放在工作空间根目录
CI 集成：在 CI 中运行 linthis -c --lang rust 以保持一致的检查
复杂度限制：设置 max_complexity = 15 以保持代码可维护
Unwrap 处理：考虑在生产代码中将 clippy::unwrap_used 视为错误