注意事项

由于Go是不支持热编译特性的，每一次代码变更后都要重新手动停止、编译、运行代码文件。run命令也不是实现热编译功能，而是提供了自动编译功能，当开发者修改了项目中的go文件时，该命令将会自动编译当前程序，并停止原有程序，运行新版的程序。

run命令会递归监控当前运行目录的所有go文件变化来实现自动编译。

使用帮助

  1. $ gf run -h
  2. USAGE
  3.     gf run FILE [OPTION]
  5. ARGUMENT
  6.     FILE    building file path.
  8. OPTION
  9.     -p, --path         output directory path for built binary file. it's "manifest/output" in default
  10.     -e, --extra        the same options as "go run"/"go build" except some options as follows defined
  11.     -a, --args         custom arguments for your process
  12.     -w, --watchPaths   watch additional paths for live reload, separated by ",". i.e. "manifest/config/*.yaml"
  13.     -h, --help         more information about this command
  15. EXAMPLE
  16.     gf run main.go
  17.     gf run main.go --args "server -p 8080"
  18.     gf run main.go -mod=vendor
  19.     gf run main.go -w "manifest/config/*.yaml"
  21. DESCRIPTION
  22.     The "run" command is used for running go codes with hot-compiled-like feature,
  23.     which compiles and runs the go codes asynchronously when codes change.

配置文件格式示例：

  1. gfcli:
  2.   run:
  3.     path:  "bin"
  4.     extra: ""
  5.     args:  "all"
  6.     watchPaths:
  7.     - api/*.go
  8.     - internal/controller/*.go

参数介绍：

名称默认值含义示例
path

manifest/output

指定编译后生成的二进制文件存放目录。
extra
指定用于底层go build的命令参数
args
指定启动运行二进制文件的命令行参数
watchPath
指定本地项目文件监听的文件路径格式，支持多个路径使用,覆盖分隔。该参数的格式同标准库的filepath.Match方法参数

internal/*.go

使用示例

一般gf run main.go即可

  1. $ gf run main.go --swagger
  2. 2020-12-31 00:40:16.948 build: main.go
  3. 2020-12-31 00:40:16.994 producing swagger files...
  4. 2020-12-31 00:40:17.145 done!
  5. 2020-12-31 00:40:17.216 gf pack swagger packed/swagger.go -n packed -y
  6. 2020-12-31 00:40:17.279 done!
  7. 2020-12-31 00:40:17.282 go build -o bin/main  main.go
  8. 2020-12-31 00:40:18.696 go file changes: "/Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf-demos/packed/swagger.go": WRITE
  9. 2020-12-31 00:40:18.696 build: main.go
  10. 2020-12-31 00:40:18.775 producing swagger files...
  11. 2020-12-31 00:40:18.911 done!
  12. 2020-12-31 00:40:19.045 gf pack swagger packed/swagger.go -n packed -y
  13. 2020-12-31 00:40:19.136 done!
  14. 2020-12-31 00:40:19.144 go build -o bin/main  main.go
  15. 2020-12-31 00:40:21.367 bin/main 
  16. 2020-12-31 00:40:21.372 build running pid: 40954
  17. 2020-12-31 00:40:21.437 [DEBU] [ghttp] SetServerRoot path: /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf-demos/public
  18. 2020-12-31 00:40:21.440 40954: http server started listening on [:8199]
  19. ...

常见问题

too many open files on macOS