Objective-C 语言指南¶

linthis 使用 cpplint 和 clang-tidy 进行代码检查，使用 clang-format 进行代码格式化。

支持的文件扩展名¶

.m
.mm
.h（根据内容自动检测）

必需工具¶

与 C++ 相同 - 请参阅 C++ 语言指南。

代码检查：cpplint¶

pip install cpplint

格式化：clang-format¶

# macOS
brew install clang-format

# 或安装 LLVM
brew install llvm

配置¶

基本示例¶

# .linthis/config.toml

[oc]
linelength = 120
excludes = ["Pods/**", "Carthage/**"]
cpplint_filter = "-build/header_guard,-runtime/int"

可替代的键名：

[objectivec]
linelength = 120

Clang-tidy 忽略检查¶

[oc]
clang_tidy_ignored_checks = [
    "clang-analyzer-osx.cocoa.RetainCount",
    "clang-analyzer-osx.cocoa.SelfInit"
]

自定义规则¶

[[rules.custom]]
code = "oc/no-nslog"
pattern = "NSLog\\s*\\("
message = "Remove NSLog before release"
severity = "warning"
languages = ["oc"]

[[rules.custom]]
code = "oc/arc-bridge"
pattern = "__bridge"
message = "Review ARC bridge usage"
severity = "info"
languages = ["oc"]

CLI 用法¶

# 仅检查 Objective-C 文件
linthis -c --lang oc

# 仅格式化 Objective-C 文件
linthis -f --lang oc

Clang-Format 配置¶

创建 .clang-format：

BasedOnStyle: Google
Language: ObjC
ObjCSpaceAfterProperty: true
ObjCSpaceBeforeProtocolList: true
ColumnLimit: 120

头文件检测¶

linthis 在 .h 文件包含以下内容时自动检测为 Objective-C： - #import 或 @import 语句 - @interface、@implementation、@protocol - NS 类型（NSString、NSArray 等） - Objective-C 方法语法（+ (、- (）

常见问题¶

.h 文件被检测为 C++¶

如果 .h 文件被错误检测，确保它们包含 Objective-C 模式或显式指定：

linthis -c --lang oc src/

Pods/Carthage 被检查¶

添加到排除项：

[oc]
excludes = ["Pods/**", "Carthage/**", "Vendor/**"]

最佳实践¶

使用 .clang-format：ObjC 特定风格的一致格式化
排除依赖：将 Pods/Carthage 添加到排除项
ARC 考虑：审查 __bridge 使用警告
NSLog 清理：发布前移除调试日志