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

使用方式

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

我们已经预编译了常见系统平台的二进制（根据自己的系统环境选择）：https://github.com/gogf/gf/releases

如果你的网络下载比较慢，可以使用加速下载：https://toolwa.com/github/

下载

预编译

自行编译

  1. 下载源码https://github.com/gogf/gf
  2. 根据自己的需要修改数据库依赖，文件/cmd/gf/internal/cmd/cmd_gen_dao.go的import。sqlite 和oracle 的驱动需要安装cgo环境
  3. 进入到gf cli的源码目录/cmd/gf 编译

安装到系统：

  • Linux or MacOS ：下载时已包含安装步骤
  • Windows： 直接双击打开按步骤操作

使用：

安装后可在命令行的任意目录中使用gf 命令，执行gf -v测试是否安装成功


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

如果是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

使用

C:\Users\Administrator>gf -v
GoFrame CLI Tool v2.0.6, https://goframe.org
GoFrame Version: cannot find go.mod
CLI Installed At: C:\Users\Administrator\go\bin\gf.exe
CLI Built Detail:
  Go Version:  go1.17.7
  GF Version:  v2.0.6
  Git Commit:  2022-03-31 16:57:32 66803fd6641e31c60f0489180668243ea092b87b
  Build Time:  2022-03-31 16:55:38
Content Menu

搜索

复制

搜索

复制

  • No labels

24 Comments

  1. 济南软件开发

    windows系统安装

    1. 刘羽禅

      请下载gf.exe进行安装

      具体请看

      https://github.com/gogf/gf-cli/blob/master/README_ZH.MD

    2. 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。有没有其他更好的方法？