静态分析Golang语言生成函数调用关系的利器——go-callvis

目录

  • 升级go
    • 删除旧版本
    • 安装新版本
    • 配置环境变量
    • 载入环境
      • 修改当前环境
      • 修改之后进入的环境
  • 分析
    • 安装go-callvis
    • 分析其他包
      • 总结
    • 导出文件
      • 总结
    • 清晰主体脉络
      • 总结
    • 其他
  • 参考资料

不同于之前分析C语言项目的工具,go-callvis还是很方便使用。只要把两项工作做好就能顺利的使用。

  1. go使用1.19及以上版本。
  2. 要在被分析工程的根目录执行分析指令。

我的测试环境是Ubuntu 22 TLS版,默认的Golang是1.18。这会导致go-callvis安装失败。如果版本匹配,可以忽略下面Golang升级的步骤。

升级go

删除旧版本

sudo apt remove golang-go golang-1.18-doc golang-1.18-go golang-1.18-src

安装新版本

直接上1.21版本。

sudo apt install golang-1.21

配置环境变量

sudo vim /etc/profile

在文件末尾另起新行填入以下内容

export GOROOT=/usr/lib/go-1.21
export GOPATH=$HOME/gowork
export GOBIN=$GOPATH/bin
export PATH=$GOPATH:$GOBIN:$GOROOT/bin:$PATH

载入环境

修改当前环境

source /etc/profile

修改之后进入的环境

sudo vim ~/.bashrc

在文件末尾另起一行新增

source /etc/profile

分析

我们以gorush的源码为例。它是一套基于Gin实现的消息推送框架。

https://github.com/appleboy/gorush.git

安装go-callvis

进入待分析工程目录

cd gorush

然后安装

go install github.com/ofabry/go-callvis@master

最后执行分析命令

go-callvis ./

2024/01/28 07:55:35 http serving at http://localhost:7878
2024/01/28 07:55:35 OpenURL error: exec: “xdg-open,x-www-browser,www-browser”: executable file not found in $PATH

这样我们就在浏览器中打开http://localhost:7878看到分析结果
静态分析Golang语言生成函数调用关系的利器——go-callvis_第1张图片
go-callvis默认是寻找main包名,并以此为入口分析代码调用关系的。而且每个方法是以包名聚合的。如上图中,nats就是一个包名,其下的方法都被聚合在一起。这个特性由-group指定,默认是pkg(包),还可以是type。

分析其他包

如果我们希望分析其他包名,则需要使用-focus指定,而且路径要制定到包所在的目录(注意不是根目录),并且还要添加-algo static。如果路径不对,go-callvis会找不到对应的包(不会遍历子目录)。比如我们需要查看router包,它实际位于~/gorush/router目录下。如果执行

go-callvis -focus router -algo static ./

则会报错

focus failed, could not find package: router

正确的指令是

 go-callvis -algo static -focus router ./router/

静态分析Golang语言生成函数调用关系的利器——go-callvis_第2张图片

总结

 go-callvis -algo static -focus 【package_name】 ./【package_path】

导出文件

上述方法都会启动一个服务器,然后在浏览器中查看。如果网络环境不允许,则我们可以让其产出图片。-format用于指定文件格式;-file用于指定导出的文件名。

 go-callvis -algo static \
  -focus router \
  -format=png \
  -file=gorush_router \
  ./router/

2024/01/28 08:14:51 writing dot output…
2024/01/28 08:14:51 converting dot to png…


如果觉得这个图太长,则可以使用-rankdir转变成其他绘制方向([LR | RL | TB | BT] (default “LR”))。

go-callvis -algo static \
 -focus router \
 -format=png \
 -file=gorush_router_tb \
 -rankdir TB \
 ./router/

总结

 go-callvis -algo static \
  -focus 【package_name】\
  -format=[svg | png | jpg | ...] (default "svg")\
  -file=【file_name】\
  ./【package_path】

清晰主体脉络

上面的图片还是很大,提供了大量信息。但是大量的信息也会带来一些干扰,我们可以通过增加一些参数,忽略一些不太重要的信息,来让调用框架清晰起来。

-nointer
Omit calls to unexported functions.
-nostd
Omit calls to/from packages in standard library.

-nostd表示标准库的包就不用展现了,这个可以省去大量最后一层的调用关系;-nointer则表示忽略非导出方法,这样我们就关注于包之间调用关系即可。

go-callvis -algo static \
 -focus router \
 -format=png \
 -file=gorush_router_noiter_nostd \
 -nointer -nostd \
 ./router/

静态分析Golang语言生成函数调用关系的利器——go-callvis_第3张图片

总结

 go-callvis -algo static \
  -focus 【package_name】\
  -format=[svg | png | jpg | ...] (default "svg")\
  -file=【file_name】\
  -nointer -nostd \
  ./【package_path】

其他

我还对gin的源码做了测试

git clone https://github.com/gin-gonic/gin.git
cd gin
go install github.com/ofabry/go-callvis@master
go-callvis -algo static -focus gin -format=png -file=gin -nointer -nostd ./

参考资料

  • https://github.com/ondrajz/go-callvis/tree/master

你可能感兴趣的:(IT项目研发过程中的利器,golang,开发语言,后端)