推荐使用go install命令安装GoFrame CLI工具:go install github.com/gogf/gf/v2/cmd/gf@latest,安装后需确保$GOPATH/bin加入PATH,再执行gf version验证是否成功输出v2.10.0。

要在本地开发环境中快速获得GoFrame官方命令行工具gf,必须明确区分“安装gf CLI”和“引入gf框架库”这两件事——前者是开发辅助工具,后者才是项目依赖。当前最新稳定版为v2.10.0,所有方式均需Go 1.16+环境支持。
方法一:go install(推荐,适用于绝大多数开发者)
打开终端,执行以下命令:
go install github.com/gogf/gf/v2/cmd/gf@latest
该命令会将gf二进制文件安装到$GOPATH/bin目录。若执行后提示command not found: gf,说明$GOPATH/bin未加入系统PATH环境变量——这是新手最常卡住的环节,务必检查并补全。
验证是否生效:运行gf version,输出含v2.10.0即成功。
方法二:下载预编译二进制(适合无Go环境或网络受限场景)
访问GitHub Release页面:https://www.php.cn/link/d292974a12895cb3f54966cfc83576a8,找到最新v2.x版本的Assets列表。
根据系统选择对应包:gf_2.10.0_windows_amd64.zip(Windows)、gf_2.10.0_darwin_arm64.tar.gz(macOS M系列)、gf_2.10.0_linux_amd64.tar.gz(Linux x86_64)。
解压后得到gf可执行文件,将其移动至系统PATH路径下(如/usr/local/bin或Windows的%SystemRoot%\System32),并赋予执行权限:chmod +x gf(Linux/macOS)。
注意:Windows用户若下载zip包,解压后需手动重命名为gf.exe,否则系统无法识别为可执行命令。
方法三:源码构建(仅限需调试CLI源码或定制功能)
第一步:克隆仓库 → 第二步:进入cmd/gf子目录 → 第三步:执行构建命令:
git clone https://github.com/gogf/gf.git
cd gf/cmd/gf
go build -o gf
构建完成后,当前目录生成gf文件。此时不要直接运行,先确认Go版本是否≥1.21——【低于1.21会导致grpcx等组件生成失败】。
将生成的gf复制到PATH路径下,即可全局调用。

















