Golang出现File is not `gofmt`-ed with `-s`报错的原因及解决方法

该报错由CI工作流中配置的Go代码格式检查规则触发：你的linter规则启用了gofmt的-s（简化模式）校验，该模式会自动识别并简化冗余的Go语法写法（比如多余的类型声明、冗余的切片初始化表达式等），要求所有提交的Go代码必须经过带-s参数的gofmt工具格式化后才可合并。你本次提交的pkg/api/api.go文件未经过该流程处理，因此触发了校验失败。

• 快速修复单文件问题：在本地项目根目录执行命令 gofmt -s -w pkg/api/api.go，其中-s参数启用代码简化规则，-w参数会将格式化后的结果直接写入原文件，执行完成后重新提交修改即可通过CI检查。
• 避免后续出现同类问题：
  • 日常开发时可配置IDE自动格式化：在VSCode、GoLand等常用开发工具的Go插件设置中，开启「保存时自动执行gofmt -s格式化」选项，保存文件时自动完成格式对齐，无需手动执行命令。
  • 配置本地git pre-commit钩子：在本地仓库的pre-commit钩子中加入gofmt检查逻辑，每次提交代码前自动校验所有修改的Go文件格式，不符合要求的提交会直接拦截，从源头避免CI格式检查失败。

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