1.Air介绍
怎样才能在基于gin框架开发时实现实时加载功能呢?像这种烦恼肯定不会只是你一个人的烦恼,所以我报着肯定有现成轮子的心态开始了全网大搜索。果不其然就在Github上找到了一个工具:Air。它支持以下特性:
彩色日志输出
自定义构建或二进制命令
支持忽略子目录
启动后支持监听新目录
更好的构建过程
安装Air
在这里就介绍大众使用的两个版本MacOS和Windows;(建议使用 第一种)
1.这里有一个适用所有的方法:
//1.16可以同时使用这两种方法
go get -u github.com/cosmtrek/air //1.16及其以前
go install github.com/cosmtrek/air@latest //1.16及其以后
注意:在这里大家要注意一下,go从1.16之后不再建议使用go get来获取依赖,但是1.16还是阔以使用go get来获取,1.17之后使用go install来获取相关的依赖
如果出现权限限制使用。sudo+go get -u github.com/cosmtrek/air(1.16版本之前)来强制获取,
2.MacOS
curl -fLo air https://git.io/darwin_air
3.Windows
curl -fLo air.exe https://git.io/windows_air
.使用Air:
为了敲命令时更简单更方便,你应该把alias air='~/.air'(有问题)加到你的.bashrc或.zshrc中。 //这里有个天坑。在后面的问题4种我会详细讲解
首先进入你的项目目录:
cd /path/to/your_project //或者在相关项目下直接操作
最简单的用法就是直接执行下面的命令:
# 首先在当前目录下查找 `.air.conf`配置文件,如果找不到就使用默认的
air -c .air.conf //这里执行的是自己创建的.air.conf文件,.air,conf中配置运行过程中的相关操作,下面有讲
正常操作流程
#1.通过终端进入相关的项目
#2.直接在编辑器中进入这个项目或者直接在这个项目下
# 1. 在当前目录创建一个新的配置文件.air.conf
touch .air.conf //也阔以手动在项目根目录下创建
# 2. 复制 `air.conf.example` 中的内容到这个文件,然后根据你的需要去修改它(下面有)
# 3. 使用你的配置运行 air, 如果文件名是 `.air.conf`,只需要执行 `air`。
air
air_example.conf示例(重要)
# [Air](https://github.com/cosmtrek/air) TOML 格式的配置文件
# 工作目录
# 使用 . 或绝对路径,请注意 `tmp_dir` 目录必须在 `root` 目录下
root = "."
tmp_dir = "tmp"
[build]
# 只需要写你平常编译使用的shell命令。你也可以使用 `make`
# Windows平台示例: cmd = "go build -o tmp\main.exe ."
cmd = "go build -o ./tmp/main ."
# 由`cmd`命令得到的二进制文件名
# Windows平台示例:bin = "tmp\main.exe"
bin = "tmp/main"
# 自定义执行程序的命令,可以添加额外的编译标识例如添加 GIN_MODE=release
# Windows平台示例:full_bin = "tmp\main.exe"
full_bin = "APP_ENV=dev APP_USER=air ./tmp/main"
# 监听以下文件扩展名的文件.
include_ext = ["go", "tpl", "tmpl", "html"]
# 忽略这些文件扩展名或目录
exclude_dir = ["assets", "tmp", "vendor", "frontend/node_modules"]
# 监听以下指定目录的文件
include_dir = []
# 排除以下文件
exclude_file = []
# 如果文件更改过于频繁,则没有必要在每次更改时都触发构建。可以设置触发构建的延迟时间
delay = 1000 # ms
# 发生构建错误时,停止运行旧的二进制文件。
stop_on_error = true
# air的日志文件名,该日志文件放置在你的`tmp_dir`中
log = "air_errors.log"
[log]
# 显示日志时间
time = true
[color]
# 自定义每个部分显示的颜色。如果找不到颜色,使用原始的应用程序日志。
main = "magenta"
watcher = "cyan"
build = "yellow"
runner = "green"
[misc]
# 退出时删除tmp目录
clean_on_exit = true