使用Air实现Go程序实时热重载及出现问题详解：

文章目录

使用Air实现Go程序实时热重载及出现问题详解：
- - 1.为什么需要实时加载？
  - 2.Air介绍
  - 3.安装Air
  - - 1.**这里有一个适用所有的方法：**
    - 2.MacOS
    - 3.Windows
  - 4.使用Air：
  - - 4. air_example.conf示例(重要)
  - 5.问题解决：
  - - 1.未设置代理（GOPROXY）造成的timeout问题（超时问题）：
    - 2.GO111MODULE
    - 3.版本问题
    - 4.报错：没有在某个文件中找到air （我就是被这个东西搞了几天，心态都快炸了）
    - "command not found: air" or "No such file or directory" ”命令未找到: air”或”没有这样的文件或目录”

前言：本文参考李文周的“使用Air实现Go程序实时热重载”和这个依赖的github（同下），但是其中有些地方容易出错，让人误解，所以，在这里我将自己出现的问题结合进来进行详细解答：适用Mac电脑

大家也阔以去相关github学习：https://github.com/cosmtrek/air

1.为什么需要实时加载？

我在之前走vue阶段的时候，只要我们保存代码，这边就立马自动的运行起来，不用我们在自己手动的开始运行，这在日常的开发中是十分好用而且阔以加快项目的开发。在学习go语言的时候，我每一次改完相关的模块都要重新启动测试，这也造成一定的不适和时间的损失，但在学习的过程中么，李文周老师介绍了一个包，air只要是适用这个包之后，就阔以实现项目热加载。

2.Air介绍

怎样才能在基于gin框架开发时实现实时加载功能呢？像这种烦恼肯定不会只是你一个人的烦恼，所以我报着肯定有现成轮子的心态开始了全网大搜索。果不其然就在Github上找到了一个工具：Air。它支持以下特性：

彩色日志输出
自定义构建或二进制命令
支持忽略子目录
启动后支持监听新目录
更好的构建过程

3.安装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

4.使用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

4. 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 tmpmain.exe ."
cmd = "go build -o ./tmp/main ."
# 由`cmd`命令得到的二进制文件名
# Windows平台示例：bin = "tmpmain.exe"
bin = "tmp/main"
# 自定义执行程序的命令，可以添加额外的编译标识例如添加 GIN_MODE=release
# Windows平台示例：full_bin = "tmpmain.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

5.问题解决： 1.未设置代理（GOPROXY）造成的timeout问题（超时问题）：

有的同学在下载时会出现timeout超时问题，这样的话就是Go1.13之后GOPROXY默认值为https://proxy.golang.org，在国内是无法访问的，所以十分建议大家设置GOPROXY，这里我推荐使用goproxy.cn。

go env -w GOPROXY=https://goproxy.cn,direct

建议大家看以我的前一篇博客：https://blog.csdn.net/weixin_51261234/article/details/123555904?spm=1001.2014.3001.5501（详细讲解代理的相关配置）

2.GO111MODULE

要启用go module支持首先要设置环境变量GO111MODULE，通过它可以开启或关闭模块支持，它有三个可选值：off、on、auto，默认值是auto。

GO111MODULE=off禁用模块支持，编译时会从GOPATH和vendor文件夹中查找包。
GO111MODULE=on启用模块支持，编译时会忽略GOPATH和vendor文件夹，只根据 go.mod下载依赖。
GO111MODULE=auto，当项目在$GOPATH/src外且项目根目录有go.mod文件时，开启模块支持。

简单来说，设置GO111MODULE=on之后就可以使用go module了，以后就没有必要在GOPATH中创建项目了，并且还能够很好的管理项目依赖的第三方包信息。

使用 go module 管理依赖后会在项目根目录下生成两个文件go.mod和go.sum。

3.版本问题

若大家在写项目的时候出现版本更改的时候一定要注意1.16这个版本，依赖的获取当时发生了变化，我在一开始的时候以为是自己的版本太低使用最新的1.18，之后还在使用go get来获取，发现，出现版本问题，所以大家如果有在项目的开发过程中切换版本的话一定要注意这一点。

4.报错：没有在某个文件中找到air （我就是被这个东西搞了几天，心态都快炸了） “command not found: air” or “No such file or directory” ”命令未找到: air”或”没有这样的文件或目录”

1. 在4.使用Air中的1中，为了敲命令时更简单更方便，通过air来启动相关路径下的文件，但是我看的那篇博客没有讲，只是说你应该把alias air='~/.air'加到你的.bashrc或.zshrc中，然后我就照做了，然后就一直在不到我的air，最后在排查了左右的可能问学长才发现这个问题，淦，心态快炸了。搞了我几天心态了。alias air=’~/.air’ 这里的``中一定要填写你电脑中air执行文件的目录，这里只是相当于将相关目录下的执行文件起了一个别名，可以通过别名直接执行，哎，希望大家可以少走点弯路，多学点知识。

2.除了上面这个问题之外还有一种情况会造成上面这种情况：

答：你的环境变量配置出错。

#go的相关配置
export GOROOT=/usr/local/go   #go安装的目录
export GOBIN=$GOROOT/bin
export PATH=$PATH:$GOBIN

# go module相关设置
export GO111MODULE=on                //GO111MODULE=on之后就可以使用go module了 
export GOPROXY=https://goproxy.cn    //配置代理

根据这个阔以查看自己的环境变量是否配置错误

使用Air实现Go程序实时热重载及出现问题详解：

Go语言相关栏目本月热门文章