如何使用gofmt批量将Go语言公有函数重命名为私有函数

操作前务必先把全量代码提交到版本控制系统，这类批量修改操作出错可以快速回滚

你之前用gofmt -r做单函数替换效率太低，而且纯文本替换容易误改注释、字符串里的同名内容，不推荐用这种方式做批量处理，下面是几个可落地的方案：

• 优先选专用未使用代码检测工具，不用改函数权限
  你改公有函数为私有的核心目的是让staticcheck识别未使用函数，其实完全不用多此一举改代码：直接安装官方的deadcode工具即可，它支持检测全项目所有未被调用的函数，不管是私有还是公有，不会漏检。
  安装命令：

  go install golang.org/x/tools/cmd/deadcode@latest
  

  在项目根目录执行deadcode ./...就能直接输出所有未使用的函数列表，零代码修改就能达到你要的效果。

• 如果确实需要批量把公有函数转私有，用类型安全的重命名工具
  不要用纯文本替换，用Go官方提供的gorename工具做重命名，它能识别代码语法结构，自动同步修改所有函数引用点，不会误改非代码内容。

  1. 先安装工具：

  go install golang.org/x/tools/cmd/gorename@latest
  

  2. 执行下面的bash脚本，就能自动遍历当前目录下所有Go文件里的首字母大写的公有函数，批量转成小写开头的私有函数，所有调用点会同步修改：

  #!/bin/bash
  grep -E '^func [A-Z]' *.go | awk '{print $2}' | sed 's/(.*//' | sort -u | while read -r func; do
    first_char_lower=$(echo "${func:0:1}" | tr '[:upper:]' '[:lower:]')
    private_name="${first_char_lower}${func:1}"
    gorename -from ".*.$func" -to "$private_name"
  done
  

• 小项目可以直接用IDE重构能力
  如果文件数量不多，直接用GoLand、VS Code（装Go插件）的全局符号搜索，筛选当前包内所有首字母大写的函数，逐个右键执行重命名重构即可，IDE会自动预览所有要修改的位置，你可以手动排除掉需要保留为公有的对外API函数，避免误改。

注意：不要无脑把所有公有函数转私有，首字母大写的导出函数很多是给外部模块调用的公开API，哪怕当前项目内部没有调用点，也可能是对外提供的能力，修改前一定要确认函数的使用范围，避免破坏兼容性。

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