零基础windows装go只需三步:下载go1.25.0.windows-amd64.msi安装包并默认路径安装;安装后关闭所有旧cmd/powershell窗口;执行go env -w go111module=on、go env -w goproxy=https://goproxy.cn,direct、go env -w gosumdb=sum.golang.org配代理。

Windows 上零基础装好 Go 并能 go run 跑起来,不需要改任何环境变量(用 .msi 安装包)、不用手动配 GOPATH、也不用碰 GOROOT —— 只要三步:下载安装、关掉旧终端、配代理拉包。其他全是干扰项。
用 .msi 安装包跳过所有环境变量配置
Windows 新手唯一推荐方式:下载 go1.25.0.windows-amd64.msi(当前最新稳定版),双击安装,路径选默认 C:\Program Files\Go 即可。.msi 会自动写入 GOROOT 和 PATH 到系统变量,go 命令全局可用。
常见错误现象:
- 安装完运行
go version报“不是内部或外部命令” → 没关掉之前打开的 CMD/PowerShell,重开一个就行 - 安装后
go env显示GOPATH是空的 → 正常,Go 1.16+ 默认启用模块模式,GOPATH不再影响日常开发
必须配 GOPROXY,否则 go mod download 必失败
国内不配代理,go get 或 go mod tidy 会卡在 Fetching github.com/xxx,超时后报错 timeout waiting for response 或直接退出。
执行这三条命令(PowerShell 或 CMD 都行):
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.org
说明:
-
GO111MODULE=on:强制开启模块模式,避免老式GOPATH工作区陷阱 -
GOPROXY=https://goproxy.cn,direct:七牛云代理 + 回源兜底,比https://proxy.golang.org稳定得多 -
GOSUMDB=sum.golang.org:校验包完整性,不能设成off,否则go get会拒绝安装
go run main.go 能跑通,不代表本地部署就 OK
很多教程止步于 go run main.go 输出 Hello World,但这只是解释执行;真正本地部署需要生成可执行文件并验证它脱离源码也能运行。
操作建议:
- 新建文件夹,比如
D:\hello,在里面建main.go,内容保持最简:package main import "fmt" func main() { fmt.Println("Hello World") } - 进该目录,执行
go mod init hello(初始化模块,生成go.mod) - 执行
go build -o hello.exe→ 生成独立 exe,不依赖 Go 环境 - 把
hello.exe复制到桌面或另一个空文件夹,双击或命令行运行,确认仍输出Hello World
关键点:没执行 go mod init 就直接 go build,在新项目里可能报 go: not in a module;而用 go run 却不报 —— 这就是容易忽略的模块初始化门槛。
VS Code 调试前别急着装插件
刚装好 Go,VS Code 打开 main.go 会提示 “Missing tools”,点“Install All”看似省事,但实际会触发一连串代理失败的工具下载(gopls、dlv 等),卡住整个编辑器。
正确做法:
- 先确保上面三步(安装、关终端、配代理)全部完成且
go env | findstr GOPROXY有输出 - 再在 VS Code 中按
Ctrl+Shift+P,输入Go: Install/Update Tools,勾选全部,回车 - 如果某工具反复失败(如
gopls),单独执行:go install golang.org/x/tools/gopls@latest
本质问题不是插件本身,而是工具二进制也是通过 go install 下载的 —— 没代理,它和 go get 一样会挂。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











