Windows 安装 Golang 完整教程:小白也能一次搞定
很多刚接触编程的朋友想在 Windows 电脑上跑 Go 语言项目,却卡在安装这一步。蓝屏、环境变量配不对、命令行提示“不是内部命令”……这些坑我见过太多。今天这篇就用最直白的话,把 Windows 安装 Golang 的全过程拆开讲清楚,从下载到写第一个程序,全部可直接照着做。
为什么选 Go,以及安装前你需要知道的
Go 语言(Golang)是 Google 推出的开源编程语言,编译快、并发强、部署简单,特别适合写后端服务、微服务、命令行工具。Windows 上安装它其实比很多语言都省事,官方提供一键安装包,装完基本就能用。
系统要求很宽松:Windows 7 及以上(推荐 Win10/Win11),64 位系统优先。硬盘至少留 500MB 空间就够。安装前建议关掉杀毒软件的实时防护几分钟,避免误拦安装程序。
准备工作:选对版本和下载源
打开浏览器,直接去官方地址下载:https://go.dev/dl/
页面会自动识别你的系统。目前稳定版一般是 1.22 或 1.23 系列,选带 Windows 和 amd64 的 .msi 安装包(推荐)。.msi 会自动帮你配好大部分路径,比 zip 解压省心多了。
国内网络有时慢,可以改用镜像:
- 清华源:https://mirrors.tuna.tsinghua.edu.cn/golang/
- 或者直接搜“golang 国内镜像”找最新可用链接。
下载完成后,记住文件放在哪里,比如桌面或下载文件夹。
正式安装:跟着界面点就行
- 双击下载好的 .msi 文件。
- 弹出安装向导,点“Next”。
- 同意协议,继续 Next。
- 安装路径默认是
C:\Program Files\Go,一般不用改。如果你电脑 C 盘空间紧张,可以点“Change”改到 D 盘,比如D:\Go。 - 再点 Next,然后 Install。过程很快,一两分钟结束。
- 完成后点 Finish。
安装程序会自动把 Go 的 bin 目录加到系统 PATH 里,大部分情况下不用手动折腾。但为了保险,我们还是检查一下环境变量。
配置环境变量(关键一步,别跳过)
很多小白装完打 go version 报错,就是这里没配好。
按 Win + S 搜索“环境变量”,打开“编辑系统环境变量” → 点“环境变量”按钮。
在“系统变量”区域做两件事:
第一,确认 PATH
找到 Path 这一行,双击打开。看里面有没有 C:\Program Files\Go\bin(如果你改了路径就对应改)。没有的话点“新建”,把这个路径加进去。
第二,可选但推荐加两个变量
- 新建
GOROOT,值设为C:\Program Files\Go(你的安装路径)。 - 新建
GOPATH,值设为C:\Users\你的用户名\go(这是以后放项目和第三方包的地方,也可以改到 D:\go 之类)。
全部确定保存后,必须关掉所有已打开的命令提示符窗口,重新开一个新的。
验证安装是否成功
按 Win + R,输入 cmd 回车,打开命令行。依次输入下面两条:
go version
正常会显示类似 go version go1.22.5 windows/amd64。
再输入:
go env
会列出一堆环境信息,重点看 GOROOT 和 GOPATH 是否正确,以及 GOOS=windows、GOARCH=amd64。
如果这两条都正常,恭喜你,安装成功了。
写第一个 Hello World 程序
验证完直接上手写代码,最有成就感。
- 在任意位置新建文件夹,比如
D:\mygo。 - 在里面新建文本文件,改名为
hello.go(注意后缀是 .go,不是 .txt)。 - 用记事本打开,写入以下内容:
package main
import "fmt"
func main() {
fmt.Println("Hello, Golang on Windows!")
}
- 保存后,回到命令行,用
cd进入这个文件夹:cd /d D:\mygo - 运行:
go run hello.go
屏幕上马上打印出那句 Hello。想编译成 exe 的话,输入:
go build hello.go
会生成 hello.exe,双击就能跑。
国内加速:配置 GOPROXY(强烈建议)
Go 默认从国外拉包,经常超时。在命令行执行一次:
go env -w GOPROXY=https://goproxy.cn,direct
或者用七牛云的:
go env -w GOPROXY=https://goproxy.io,direct
以后 go get 或 go mod tidy 都会快很多。再加一句:
go env -w GO111MODULE=on
开启模块模式,现在是默认推荐方式。
常见问题与快速解决
-
提示“go 不是内部或外部命令”
环境变量 PATH 没加对,或者没重启命令行。重新检查 Path,关掉所有 cmd 再开。 -
安装后 go version 显示旧版本
卸载旧版,重新装新 .msi。或者手动删掉旧的 Go 目录。 -
go get 超时或失败
先配好上面的 GOPROXY。公司网络有代理的话,再设go env -w HTTP_PROXY=你的代理地址。 -
权限不足
以管理员身份运行安装程序和命令行。 -
想换版本
直接再装一次新 .msi 覆盖,或者用 gvm 这类版本管理工具(进阶用户)。
进阶小建议:装个好用的编辑器
记事本写代码太原始。推荐免费的 VS Code:
- 官网下载 VS Code 安装。
- 打开后点左侧扩展图标,搜 “Go”,安装官方 Go 插件。
- 插件会提示你安装 gopls、dlv 等工具,点 Install All 就行。
- 以后打开 .go 文件就有语法高亮、自动补全、一键运行了。
如果你更喜欢 JetBrains 全家桶,GoLand 也很强,不过要付费。
装完 Go 之后,建议再学一下 go mod init 创建模块、go test 写测试这些基础命令。Windows 上跑 Go 项目几乎没有平台差异,编译出的 exe 直接就能分发。
按照上面步骤做完,从零到能写程序通常不超过 15 分钟。环境配好一次,后面换项目都省心。有硬件兼容或网络特殊情况再针对性调整就行。

还没有评论,来说两句吧...