在Xcode中通过SwiftLint或原生构建脚本识别删除无用代码

1. 配置规则与构建集成 #

SwiftLint自带unused_declaration规则，可精准检测未使用的函数、属性等。在项目根目录创建或编辑.swiftlint.yml，针对测试代码配置规则：

# 只扫描测试目录下的文件
included:
  - Tests/**/*.swift

# 启用未使用声明检测
opt_in_rules:
  - unused_declaration

# 设置规则级别：error会中断构建，warning仅提示
unused_declaration:
  severity: error

接着在Xcode的构建阶段添加运行脚本，每次构建自动触发检测：

if which swiftlint >/dev/null; then
  swiftlint lint --config .swiftlint.yml
else
  echo "SwiftLint未安装，请先安装后再执行"
fi

2. 自动删除无用代码 #

SwiftLint支持自动修复未使用声明，可将修复命令加入构建脚本（建议仅在Debug环境启用，避免影响正式构建）：

if which swiftlint >/dev/null; then
  # 仅在Debug模式下自动修复
  if [ "${CONFIGURATION}" = "Debug" ]; then
    swiftlint autocorrect --config .swiftlint.yml
  fi
  swiftlint lint --config .swiftlint.yml
else
  echo "SwiftLint未安装，请先安装后再执行"
fi

注意：自动修复会直接修改代码，建议先手动验证检测结果无误后再启用。

如果无法引入SwiftLint，可依赖Xcode自带的编译警告：

1. 开启原生未使用声明警告 #

在项目Build Settings中找到：

• Swift Compiler - Warnings Policies → Unused Declaration，设置为Yes（编译时会发出警告）
• 若需强制处理，可开启Treat Warnings as Errors，将警告升级为错误中断构建

2. 脚本自动删除（基础版） #

通过解析Xcode编译日志，提取未使用声明的位置并删除对应代码。创建Shell脚本并加入构建阶段：

# 编译测试目标并捕获日志
BUILD_LOG=$(xcodebuild -workspace YourWorkspace.xcworkspace -scheme YourTestScheme build 2>&1)

# 提取未使用声明的文件和行号
UNUSED_DECLS=$(echo "$BUILD_LOG" | grep "unused declaration" | sed -E 's/(.*\.swift):([0-9]+):.*unused declaration/\1:\2/')

# 遍历删除对应行（仅适用于单行声明，多行函数需扩展逻辑）
for DECL in $UNUSED_DECLS; do
  FILE=$(echo "$DECL" | cut -d: -f1)
  LINE=$(echo "$DECL" | cut -d: -f2)
  sed -i '' "${LINE}d" "$FILE"
done

提示：该脚本仅处理单行声明（如简单属性、单行函数），复杂场景需手动确认后再删除，避免误删测试框架生命周期函数（如setUp、tearDown）。

• 所有自动操作前，务必通过版本控制备份代码，提交前检查变更
• 测试代码中部分函数可能被测试框架隐式调用，需排除这类假阳性结果
• 建议先在本地验证检测逻辑的准确性，再推广到团队构建流程

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