SwiftLint 0.53.0未输出预期警告求助排查

DevOps 小满

2026-7-8

排查SwiftLint无输出问题的步骤

单独执行基础lint命令验证
先跳过--fix参数，直接在项目根目录执行：
```
swiftlint lint
```
因为--fix模式仅输出被自动修复的问题，无法自动修复的警告不会在该模式下显示。如果单独执行lint也无输出，说明问题出在配置或路径匹配环节。
检查.swiftlint.yml的规则启用状态
确认配置文件中已启用你预期的规则。比如若仅开启了少量可自动修复的规则（如trailing_whitespace），而你关注的警告对应的规则未启用，自然不会产生输出。可临时在配置中添加：
```
opt_in_rules: all
```
执行swiftlint lint测试，以此排除规则未启用的问题（测试后记得改回原配置）。
验证配置文件的路径匹配逻辑
即使你认为路径配置正确，也可手动指定文件路径测试：
```
swiftlint lint --path ./指定的Swift文件路径
```
若指定单个文件有输出，说明配置中的included/excluded规则可能存在冲突，比如误排除了目标文件或目录。
检查SwiftLint版本兼容性
0.53.0属于较旧版本，部分规则可能存在bug，或对新Swift语法支持不足。可尝试升级至最新版本：
```
brew upgrade swiftlint
```
升级后重新测试。
查看详细执行日志
执行带--verbose参数的命令，输出SwiftLint的执行细节：
```
swiftlint lint --verbose
```
日志会显示加载的配置、扫描的文件、规则应用情况等，帮助定位是未扫描到文件还是规则未生效。
确认脚本的执行目录
若脚本在Xcode Build Phase中执行，需确保执行目录为项目根目录。可在脚本中添加一行：
```
pwd
```
查看输出的当前路径是否与.swiftlint.yml所在目录一致。若路径不符，SwiftLint会加载默认配置而非自定义配置。