该命令仅针对于预编译二进制下载安装。如果通过go install命名安装的工具的话，不需要手动再使用install命令安装gf工具。

下载安装

最新版下载

Mac & Linux 快捷下载命令

wget -O gf https://github.com/gogf/gf/releases/latest/download/gf_$(go env GOOS)_$(go env GOARCH) && chmod +x gf && ./gf install -y && rm ./gf

Windows需手动下载

确定自己当前项目的goframe依赖版本，查看自己的系统信息：

go env GOOS
go env GOARCH

下载地址：Releases · gogf/gf (github.com)

通过go install安装

go install github.com/gogf/gf/cmd/gf/v2@latest # 最新版本
go install github.com/gogf/gf/cmd/gf/v2@v2.5.5 # 指定版本(版本需要 >= v2.5.5)

其它版本下载

v2版本

预编译二进制下载：Releases · gogf/gf (github.com)

源码：gf/cmd/gf

v1版本

预编译二进制下载：Releases · gogf/gf-cli (github.com)

源码：gogf/gf-cli

使用方式

项目地址：https://github.com/gogf/gf/tree/master/cmd/gf

使用方式：./gf install

该命令往往是在gf命令行工具下载到本地后执行（注意执行权限），用于将gf命令安装到系统环境变量默认支持的目录路径中，以便于在系统任何的地方直接可以使用gf工具。

部分系统需要管理员权限支持。

如果是MacOS下使用zsh的小伙伴可能会遇到别名冲突问题，可以通过alias gf=gf来解决，运行一次之后gf工具会自动修改profile中的别名设置，用户重新登录（或者重开终端）就好了。

使用示例

$ ./gf_darwin_amd64 install 
I found some installable paths for you(from $PATH):  
  Id | Writable | Installed | Path 
   0 |     true |      true | /usr/local/bin 
   1 |     true |     false | /Users/john/Workspace/Go/GOPATH/bin 
   2 |     true |     false | /Users/john/.gvm/bin 
   4 |     true |     false | /Users/john/.ft 
please choose one installation destination [default 0]: 
gf binary is successfully installed to: /usr/local/bin
Content Menu

  • No labels

32 Comments

  1. 济南软件开发

    windows系统安装

    1. beautiful

      https://github.com/gogf/gf-cli/releases

      1. 白夜

        下载下来的exe ,点击安装，闪了一下就过去了。gf -v 不能正确输出，下载的是 gf cli 2.0 版本

        1. 白夜

          喔噢，原来直接把exe 放到 bin就好了 

          1. ming

            直接放在go bin 的目录嘛？这样好像不太行吧？


            1. 白夜

              这个gf.exe放到安装目录（GOROOT）的/bin或者GOPATH的/bin都可以，其目的就是直接在命令行能引用到gf.exe就行。我是放到了GOPATH的/bin。 我的gf全路径是：

              GoFrame CLI Tool v2.0.0-rc, https://goframe.org
GoFrame Version: cannot find go.mod
CLI Installed At: E:\go-workspace\bin\gf.exe   # 安装路径
CLI Built Detail:
  Go Version:  go1.17.6
  GF Version:  v2.0.0-beta
  Git Commit:  2022-01-24 11:02:57 37d535f61e975dff1765f98e3b505aeccfec338e
  Build Time:  2022-01-24 03:01:42

              1. ming

                通过gf install  windows  还是没有更新到最新的版本目录跟上面一样的


        2. 乔大治

          我也是闪一下就过去，通过右击【以管理员身份运行】解决了

  2. honorforlee

    linux下安装，SPATH过多的时候，只默认前两个路径，且不是usr/local/go/bin下面。

  3. 阿峰

    建议在本1.16的文档上写明, 推荐安装1.16版ctl 否则官方demo会跑不起来

  4. 小伙伴

    gf update
    checking... 
    downloading... 
    Error: downloading failed for darwin amd64, may be network issue:


    执行gf update 的时候提示这个错误

    1. Lorenzo

      我也遇到这个错误了

    2. ygcool

      +1  你有解决吗？

  5. tangxinggang

    无法下载 gf.exe 

  6. sudden3

    文章中的https://github.com/gogf/gf/v2/tree/master/cmd/gf这个项目地址失效了

  7. ming

    在windows 安装gf cli v2.04的步骤

    1.https://github.com/gogf/gf-cli/releases 下载相应的安装包

    2.因为直接点击会出闪退的情况所以 直接使用cmd 命运运行就ok了

  8. 白夜

    下载失败的，可以使用我下载好的这个： https://gitee.com/xiaobin_zhao/my-gf/raw/master/myapp/resource/doc/gf_windows_amd64_v2.0.6.exe

  9. 零基础菜鸟

    win10 ltsc版本下，首先gf-cli安装双击的时候闪退，只能用 ./gf_windows_amd64.exe install 安装，gf-cli工具用powershell安装完成，gf -v 提示无法将“gf”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。用cmd安装完后如果不关闭cmd，直接在这窗口下执行没问题，如果关掉重新打开cmd 执行gf命令，就提示'gf' 不是内部或外部命令，也不是可运行的程序或批处理文件。上述问题在管理员模式下也是这种问题，网上说的修改PowerShell执行权限也不管用，折腾了一晚上一个工具没搞定。用beego的工具反而没出现过上述问题，所以有点搞不懂什么原因造成的，请各位大佬解惑。

    1. 白夜

      是不是没有把 gf.exe 放到 系统环境变量

    2. fm104510

      1、查看gf.exe所在目录是否添加到系统环境变量‘Path’中

  10. guyu

    MacBook Pro (13-inch, 2017, Four Thunderbolt 3 Ports)

    版本：10.14.4 (18E226)

    安装错误：未能打开文稿“gf_darwin_arm64” ， 文本编码“unicode（UTF-8）”不适用

    安装错误：未能打开文稿“gf_darwin_amd64” ， 文本编码“unicode（UTF-8）”不适用

    都尝试了，都有问题

    1. 煎人寿

      可以使用  

      wget -O gf https://github.com/gogf/gf/releases/latest/download/gf_$(go env GOOS)_$(go env GOARCH) && chmod +x gf && ./gf install -y && rm ./gf

      指令来安装, 如果你用的是zsh. 可以先把终端换成bash, 在执行上面那段指令. 安装完成后可以切换回来

  11. scanking

    gf 升级时gf update报错，直接安装覆盖闪退，无法卸载重装，只能卸载go后重装，再安装最新版本的gf。有没有其他更好的方法？

  12. hanwei

    有个疑问:

    系统安装的是go最新版本go1.19.5,为什么gf --version的go版本是: go1.17.13呢?

    GoFrame CLI Tool v2.3.0, https://goframe.org
    GoFrame Version: cannot find goframe requirement in go.mod
    CLI Installed At: C:\Users\hanwei\go\bin\gf.exe
    CLI Built Detail:
      Go Version:  go1.17.13
      GF Version:  v2.3.0
      Git Commit:  2023-01-11 19:20:21 f63747e87657a2e6ba9a74de1ce2b8e6defa07c0
      Build Time:  2023-01-11 19:21:37

    1. 糖水不加糖

      CLI Built Detail

    2. 海亮

      CLI Built Detail 是关于gf这个命令行工具编译时的环境信息

  13. 飞天子

    【macos在国内网络环境中升级gf cli办法】

    github国内下载很慢，使用gitee下载安装的方法：

    1、将国外github路径切换为国内gitee路径，执行命令：

    git clone https://gitee.com/johng/gf.git && cd gf/cmd/gf && go install

    2、上边命令实际上也为安装成功，用gf查看还是老版本，在确保cd到gf/cmd/gf目录前提下，执行go build进行编译

    3、执行which gf查看gf老版本安装路径，正常是在位置/usr/local/bin/gf

    4、拷贝编译后的最新版本覆盖老版本

    cp gf /usr/local/bin/gf

    至此完成升级，执行gf version正常就会显示最新版本

  14. adk23333

    Window下，先安装Go，然后将Go的目录及bin目录添加进环境变量，最后使用powershell，运行.\gf_windows_amd64.exe，选择安装到环境变量的gobin目录下即可。

    1. adk23333

      powershell必须以管理员运行

    2. 糖水不加糖

      下载好cli工具后直接复制到C:\Windows就可以直接用.

  15. canyonwan

    我这个 m2 max ,在安装的时候为何没有/usr/local/bin 的目录呢

    echo $PATH的时候是有/usr/local/bin 的，

    而且在.zshrc 里也配置了alias gf=gf

    但使用 gf 的时候还是报错：fatal: not a git repository (or any of the parent directories): .git

    我这个 m2 max ,在安装的时候为何没有/usr/local/bin 的目录呢

    echo $PATH的时候是有/usr/local/bin 的，

    而且在.zshrc 里也配置了alias gf=gf

    但使用 gf 的时候还是报错：fatal: not a git repository (or any of the parent directories): .git

  16. 奶糖不太甜

    为啥我下载最新的windows cli工具装了版本显示是2.0.0嘞