用途:为 Apple 平台 Swift 项目安装提交前代码质量钩子,在 git commit 时对暂存的 .swift 文件执行 SwiftLint --strict 与 SwiftFormat(或 swift-format)--lint 检查,可选环境变量启用 xcodebuild 类型检查。适合 Xcode 项目、工作区或 Package.swift 仓库中需要提交时强制代码规范的场景。
主要能力:按 install、audit、verify、update 四种意图分发操作;自动检测平台与项目类型;生成 .swiftlint.yml、.swiftformat、.swiftlint-baseline.json 等配置;安装 .githooks/pre-commit 并通过 git config core.hooksPath 接入;钩子分四阶段并在首个失败处中止,CI 环境自动跳过;支持遗留代码库使用 swiftlint --write-baseline 生成基线。
使用方式:先确认 swiftlint 与 swiftformat 在 PATH 中,可用 brew install 安装;执行 git config core.hooksPath .githooks 启用;钩子只针对暂存 Swift 文件运行。
限制:非 Apple 平台(如 Linux 服务端 Swift)的类型检查阶段不适用 xcodebuild;默认不开启类型检查;不直接写入 .git/hooks/;全局工具安装需先确认;visionOS 模拟器缺失等构建问题可能导致类型检查不稳定。