Rust中能否仅将crate属性应用于crate本身?
可行解决方案
以下两种方法都可以实现仅屏蔽二进制crate名称的蛇形命名警告,完全不影响crate内部代码的命名规范检查,不会出现全局关闭lint导致内部违规命名被漏过的问题。
方案一(优先推荐):通过Cargo.toml显式配置二进制目标
该方法没有任何lint层面的hack,完全符合Cargo的设计逻辑,长期维护成本最低。
- 将
src/bin目录下的大驼峰命名源文件改为Rust惯例的蛇形命名,例如将src/bin/MyFooBinary.rs重命名为src/bin/my_foo_binary.rs,src/bin/MyBarBinary.rs重命名为src/bin/my_bar_binary.rs - 在项目根目录的
Cargo.toml中添加如下配置,显式声明每个二进制目标的输出名称和对应源文件路径:
[[bin]] name = "MyFooBinary" path = "src/bin/my_foo_binary.rs" [[bin]] name = "MyBarBinary" path = "src/bin/my_bar_binary.rs"
配置完成后,编译器会直接读取Cargo.toml中定义的名称作为最终输出的二进制文件名,源文件本身符合蛇形命名规范,完全不会触发non_snake_case警告。同时crate内部的命名检查保持默认规则,后续代码中如果出现非蛇形命名的函数、变量等内容,编译器依旧会正常抛出警告。最终编译出的二进制文件为你需要的TitleCase格式,和直接使用大驼峰源文件的编译产物没有区别。
方案二:lint级别覆盖(无需修改文件名和Cargo配置)
如果你需要保留src/bin下现有的大驼峰源文件命名,也不想调整Cargo.toml配置,可以利用Rust lint属性的顺序覆盖特性,精准屏蔽仅针对crate名称的警告。
在每个大驼峰命名的二进制源文件最顶部,按顺序添加如下两行crate级别属性:
// 临时关闭non_snake_case检查,覆盖crate名称的隐式校验逻辑 #![allow(non_snake_case)] // 立刻重新开启non_snake_case警告,后续所有内部代码正常执行命名规范检查 #![warn(non_snake_case)] // 后续正常编写业务代码即可 fn main() { // 测试:如果在这里编写 fn BadName() {} 这类不符合蛇形命名的项,编译器依旧会正常抛出警告 }
该方法的实际效果等价于仅给crate名称本身加了豁免,crate内所有代码的命名检查规则和默认状态完全一致,不会漏过任何内部代码的命名违规问题。
内容的提问来源于stack exchange,提问作者Dominick Pastore
相关产品推荐
相关产品推荐

