jrkeen / go_fmt

更好用的 go代码格式化工具

Go 代码格式化

1.功能说明

• 格式化import部分：分3段式，依次为 标准库、第三方库、项目自身库
• 格式化单行注释：若为 //注释内容，调整为 //{空格}注释内容
• 默认只对git项目库里有修改的进行格式化
• 支持将多行的 copyright 注释修改为单行格式(默认不调整)

对于import部分：

1.可使用-mi参数来控制是否将多段import合并为一段（默认否）。
2.对于注释的import path,会按照其实际路径参与分组和排序。
3.对于非末行的注释的位置会和其下面紧挨的import path绑定在一起。
4.末行的注释则会放入import的头部。
5.import path 不要使用相对路径(如./ 和 ../)。

会忽略当前目录以及子目录下的testdata和vendor目录。
若需要可进入其目录里执行该命令。

2.安装/更新

使用 go >= 1.13 版本(不需要Fan强)：

export GO111MODULE=on
go env GOPROXY=https://goproxy.cn,direct

go get -u github.com/fsgo/go_fmt

go < 1.13 版本(可能需要Fan强):

go get -u github.com/fsgo/go_fmt

3.使用

3.0 help

go_fmt -help

usage: go_fmt [flags] [path ...]
  -local string
    	put imports beginning with this string as 3rd-party packages (default "auto")
  -mi
    	merge imports into one
  -slcr
    	multiline copyright to single-line
  -trace
    	show trace infos
  -w	write result to (source) file instead of stdout (default true)

3.1 格式化git项目里有修改的.go文件

$ go_fmt

3.2 对当前目录所有.go文件格式化

$ go_fmt ./...

3.3 对指定.go文件格式化

$ go_fmt abc.go

4.配置到git hooks(commit前自动格式化代码)

4.1 配置项目Hooks

编辑项目的 .git/hooks/pre-commit文件，将go_fmt命令加入。

方式1：

echo -e '\ngo_fmt\n' >> $(git rev-parse --git-dir)/hooks/pre-commit
chmod 777 $(git rev-parse --git-dir)/hooks/pre-commit

方式2：

wget https://raw.githubusercontent.com/fsgo/go_fmt/master/pre-commit -O $(git rev-parse --git-dir)/hooks/pre-commit
chmod 777 $(git rev-parse --git-dir)/hooks/pre-commit

4.2 配置到全局Hooks

该方式会导致项目自身的hooks失效。
若项目有自己的hooks，请不要配置全局而要配置到单个项目。

mkdir -p ~/.git_config/hooks/
git config --global core.hooksPath ~/.git_config/hooks/

wget https://raw.githubusercontent.com/fsgo/go_fmt/master/pre-commit -O ~/.git_config/hooks/pre-commit
chmod 777 ~/.git_config/hooks/pre-commit