SwiftLint unused_import规则无法检测未使用导入问题求助

• 规则配置位置错误：unused_import是SwiftLint的分析器规则（Analyzer Rule），仅能在analyzer_rules数组中配置，不能放在opt-in-rules内。若配置位置错误，规则完全不会生效。正确的配置示例：

  analyzer_rules:
    - unused_import
  

• SwiftLint版本过低：早期版本的SwiftLint对SPM项目的分析支持不完善，unused_import规则在旧版本中可能无法正确识别SPM项目里的未使用导入。建议升级到最新稳定版，比如用Homebrew执行brew upgrade swiftlint完成更新。

• 扫描范围未覆盖目标文件：SPM项目的源码通常存放在Sources/[TargetName]目录下，如果SwiftLint默认扫描路径没包含这些目录，就检测不到违规。可以在.swiftlint.yml中明确指定包含路径：

  included:
    - Sources/YourTarget1
    - Sources/YourTarget2
  

  或者直接在命令中指定路径：swiftlint lint --autocorrect Sources/

• 导入模块类型限制：

  • 部分系统框架（如Foundation）的未使用导入，可能因SwiftLint的分析逻辑不会被标记；
  • 若导入的是本地SPM依赖模块，需确保该模块的源码路径被包含在SwiftLint的扫描范围内，否则规则无法识别其使用情况。

• 配置文件未被正确读取：确保运行swiftlint命令的目录是项目根目录（即.swiftlint.yml所在目录），或者通过--config参数指定配置文件路径：swiftlint lint --autocorrect --config ./path/to/.swiftlint.yml

• 规则本身不支持自动修复：unused_import属于分析器规则，部分此类规则仅支持检测违规（输出提示），不支持自动修复。可先去掉--autocorrect参数运行swiftlint lint，若能检测到未使用导入但无法自动修复，说明规则本身不具备自动修复能力。

内容的提问来源于stack exchange，提问作者Daniel Pustotin