如何基于C#（Unity）代码风格检查实现Git提交推送拦截？

刚好我之前帮团队搞定过类似的C#代码风格强制检查需求，结合Git和GitHub的话，其实有几个成熟的方案可以解决你的提交拦截问题，我给你拆解一下：

一、用pre-commit钩子结合.NET工具实现本地提交拦截 #

你之前研究pre-commit钩子没成功？大概率是没把工具和钩子脚本正确结合。这里给你一套可落地的步骤：

• 首先在项目中引入Roslyn Analyzers（比如StyleCop.Analyzers，它是新版StyleCop，完全基于Roslyn，比旧版更适合集成），然后通过.editorconfig把需要强制的风格规则设为error级别——这样编译时只要有风格问题，就会直接失败。
• 安装pre-commit工具（这是个Python工具，用来管理Git钩子，不用写复杂脚本），然后在项目根目录创建.pre-commit-config.yaml配置文件：

repos:
- repo: local
  hooks:
    - id: dotnet-build-style-check
      name: 编译检查代码风格
      entry: dotnet build
      language: system
      types: [csharp]
      pass_filenames: false
    - id: dotnet-format-check
      name: 检查代码格式规范
      entry: dotnet format --check --verbosity diagnostic
      language: system
      types: [csharp]
      pass_filenames: false

配置完成后，运行pre-commit install安装钩子。之后每次提交前，Git会自动执行dotnet build和dotnet format --check，只要有风格问题就会终止提交。

二、用GitHub Actions实现远程拦截（防止绕过本地钩子） #

有些成员可能会跳过本地钩子直接提交，这时候可以用GitHub Actions在远程层面拦截：

• 在项目根目录创建.github/workflows/code-style.yml文件：

name: 代码风格强制检查
on: [pull_request, push]

jobs:
  style-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 配置.NET环境
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '8.0.x' # 替换成你项目使用的.NET版本
      - name: 还原依赖
        run: dotnet restore
      - name: 检查代码格式
        run: dotnet format --check --verbosity diagnostic
      - name: 编译检查风格规则
        run: dotnet build --no-restore

• 然后在GitHub仓库的「Settings」→「Branches」里，把这个工作流设为必需检查。这样任何PR或提交只要没通过风格检查，就无法合并到主分支。

三、结合ReSharper/FxCop的进阶方案 #

如果你习惯用ReSharper或FxCop，也能实现拦截：

• ReSharper可以用它的Command Line Tools，运行jb inspectcode命令生成检查报告，再写个简单脚本判断是否有严重违规，把这个脚本加到pre-commit钩子或GitHub Actions里。
• FxCop现在已经整合到Roslyn Analyzers中（即Microsoft.CodeAnalysis.FxCopAnalyzers），直接NuGet安装到项目，然后在.editorconfig里把规则设为error级别，就能通过编译拦截提交。

关键注意事项 #

• 一定要用.editorconfig统一团队的风格规则，不管是Roslyn Analyzers、dotnet format还是ReSharper，都会遵守这个文件的配置，避免规则不一致。
• 把需要强制的规则设为error级别，而不是警告——只有这样，检查工具才会返回非零值，触发提交拦截。

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