Go Air 热重载安装配置指南

大可-2026-08-14 9:18

Go Air 热重载安装配置指南

目标：在 Windows 上全局安装 Air，让 GoLand 开发时保存文件自动重新编译并重启程序（热重载）。

一、安装 Air（全局安装）

在 PowerShell 中执行：

powershell 复制代码

go install github.com/air-verse/air@latest

安装成功后，可执行文件位于：

复制代码

C:\Users\<你的用户名>\go\bin\air.exe

注意：go install 是全局安装，装好后所有项目都能用。

二、配置环境变量（PATH）

go install 安装的二进制默认不在系统 PATH 中，需要手动添加 go\bin 目录。

方式 A：用户级 PATH（推荐，无需管理员权限）

powershell 复制代码

$goBin = "$env:USERPROFILE\go\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$goBin*") {
    [Environment]::SetEnvironmentVariable("Path", "$userPath;$goBin", "User")
}

方式 B：系统级 PATH（需以管理员身份运行 PowerShell）

powershell 复制代码

$goBin = "$env:USERPROFILE\go\bin"
$machinePath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($machinePath -notlike "*$goBin*") {
    [Environment]::SetEnvironmentVariable("Path", "$machinePath;$goBin", "Machine")
}

修改 PATH 后必须重启终端 / GoLand 才能生效。

三、验证安装

powershell 复制代码

air -v

看到版本号即安装成功：

复制代码

  __    _   ___  
 / /\  | | | |_) 
/_/--\ |_| |_| \_ 
v1.67.4, built with Go go1.26.3

四、在 GoLand 中使用热重载

内置终端直接运行（推荐，最简单）

打开 GoLand，点击底部 Terminal 标签
确保当前目录在项目根目录（如 E:\学习\go\2）
输入命令启动热重载：

powershell 复制代码

air

效果：程序自动编译运行。之后每次 Ctrl+S 保存 .go 文件，Air 会自动重新编译并重启程序，终端显示 building... 提示即热重载生效
停止：按 Ctrl+C

五、常见问题

问题	解决
提示 `air 不是内部或外部命令`	PATH 未生效，重启终端/GoLand；或用绝对路径 `C:\Users\<用户名>\go\bin\air.exe`
系统级 PATH 添加报"注册表权限"错误	用方式 A（用户级 PATH），或以管理员身份运行
Air 启动后端口被占用	修改 `.air.toml` 中端口配置，或先 `air init` 生成配置文件