Windows 上安装 Go 开发环境完整指南：基于 learngo 课程源码的 VS Code + Git Bash 实战教程
Windows 上安装 Go 开发环境完整指南：基于 learngo 课程源码的 VS Code + Git Bash 实战教程
导读
本指南完整承接 learngo 课程仓库 01-get-started/windows-installation.md 的 Windows 环境搭建流程，手把手带你完成 Visual Studio Code + Git + Go 工具链 三件套的安装与配置。学完本指南，你将能够在 Windows 上拥有一个可直接运行 learngo 仓库 1000+ 示例程序、习题与测验的开发环境，并熟练使用 Git Bash 执行与 macOS / Linux 完全一致的命令，为后续章节的代码练习（如 02-write-your-first-program/README.md 中的 go run main.go）扫清一切环境障碍。
环境概览：本课程为什么这样配置
在开始安装之前，先说明这套组合拳背后的设计逻辑：
- Visual Studio Code（VS Code）：课程在 01-get-started/osx-installation.md 与 01-get-started/ubuntu-installation.md 等平行指南中均明确其为课程默认编辑器，官方 Go 扩展提供补全、格式化、调试等一站式能力；
- Git：不仅是代码版本管理工具，更是 Go 工具链下载第三方依赖（
go get/go install）的前置条件，同时 Git for Windows 自带的 Git Bash 是本课程在 Windows 上体验类 Unix 命令行的关键； - Go：由 golang.org/dl（
module github.com/inancgumus/learngo，go 1.13）所代表的课程代码兼容。
说明：本仓库当前模块路径为
github.com/inancgumus/learngo，其 go.mod 声明go 1.13，因此只需安装 1.13 及以上版本（建议直接安装官方最新稳定版）即可无障碍编译本仓库代码。
第 0 步：可选——用 Chocolatey 一键安装 Go
如果你已经安装了 Windows 包管理器 Chocolatey，可以跳过第 3 节的手动下载，直接以管理员身份运行 PowerShell 执行：
choco install golang
Chocolatey 会自动下载官方安装包并完成 PATH 环境变量配置，安装后新开一个终端即可使用 go version 验证。未安装 Chocolatey 的读者请继续按下面四步走。
第 1 步：安装 Visual Studio Code 编辑器
- 打开浏览器访问 https://code.visualstudio.com；
- 点击 Windows 平台按钮开始下载安装包；
- 运行下载好的安装程序，按默认选项一路 Next 完成安装；
- 先不要打开 VS Code——我们会在第 4 节安装完 Go 之后再统一配置扩展，避免重复操作。
安装完成后，VS Code 会出现在开始菜单与桌面快捷方式中。本课程在 Linux 指南（01-get-started/ubuntu-installation.md）中也强调“VSCode 不是强制选项，你也可以用其他编辑器”，但后续课程的演示均基于 VS Code，跟随本指南可减少弯路。
第 2 步：安装 Git（Git for Windows）
-
访问 https://gitforwindows.org，下载并运行安装程序；
-
在 Select Default Editor 步骤中，选择 VS Code 作为 Git 的默认编辑器；
-
后续步骤中勾选全部复选框（Enable all the checkboxes），确保 Git Bash、Git GUI、文件关联等组件全部就位；
-
在 Adjusting your PATH environment 步骤中，选择：
"Use Git from the Windows Command Prompt"
该选项会把 Git 的可执行目录加入系统 PATH，使你不仅能在 Git Bash 中，也能在 CMD 与 PowerShell 中直接使用
git命令； -
在 Configuring the line ending conversions（换行符转换）步骤中，选择：
"Checkout as is, commit as is"
即“原样检出、原样提交”，不做换行符自动转换。这一点对 Go 学习者尤其重要：Go 源码对跨平台换行（CRLF/LF）并不敏感，但保持仓库文件原样可避免意外的 diff 噪音，也让课程示例的 Git 使用体验与 macOS/Linux 保持一致。
提示：Git 也是 Go 工具链下载源码依赖的基础。正如 01-get-started/ubuntu-installation.md 中所注明的“
go get不能在没有安装代码版本管理工具（如 Git）的情况下使用”，Windows 上同理。
第 3 步：安装 Go
- 访问 https://golang.org/dl（当前官方下载页为 https://go.dev/dl，同一站点）；
- 选择 Windows 平台的
.msi安装包并下载； - 双击运行安装程序，保持默认安装目录（通常为
C:\Program Files\Go）完成安装。
安装完成后，请关闭并重新打开所有终端窗口（VS Code、CMD、PowerShell、Git Bash），让新写入的 PATH 环境变量生效。验证安装：
go version
正常输出类似 go version go1.21.x windows/amd64。若提示“不是内部或外部命令”，请检查是否漏装了第 2 步的 PATH 选项，或手动在系统环境变量中添加 C:\Program Files\Go\bin。
第 4 步：配置 VS Code 的 Go 开发环境
4.1 安装 Go 扩展
- 打开 VS Code；
- 点击左侧活动栏的 Extensions（扩展） 图标；
- 搜索关键字
go，选择由 Go 官方团队发布的 Go 扩展并安装； - 完全关闭 VS Code 后重新打开，让扩展激活。
4.2 通过命令面板安装 Go 工具链
VS Code 的 Go 扩展本身只是编辑器外壳，真正提供跳转、补全、格式化、静态检查等能力的是它调用的底层工具（如 gopls、dlv、staticcheck 等）。按以下步骤批量安装：
- 打开 View（视图） 菜单，选择 Command Palette（命令面板），或直接按快捷键
Ctrl+Shift+P； - 输入
go install，在结果中选择 "Go: Install/Update Tools"； - 在弹出的工具列表中勾选所有复选框（Check all the checkboxes），然后点击确认；
- 等待下载与安装完成（需要网络，且依赖第 2 步安装的 Git），完成后工具会安装到
%GOPATH%\bin（默认C:\Users\<用户名>\go\bin）。
提示：这批工具中常用的包括格式化工具
gofmt/goimports、语言服务gopls与调试器dlv。课程在 01-get-started/ubuntu-installation.md 中介绍 Linux 环境时也通过go get -v -u golang.org/x/tools/...安装了同类工具集，Windows 上用 VS Code 的 Install/Update Tools 即可一键完成。
第 5 步：使用 Git Bash 作为命令行环境
5.1 为什么推荐 Git Bash
本课程的所有演示命令都是 bash 语法（macOS 与 Linux 默认的命令行界面，也是最流行的命令行之一）。Windows 自带的 CMD 使用不同的语法（如列目录用 dir 而非 ls），逐一翻译会造成混乱。使用随 Git for Windows 安装的 Git Bash，你可以像在 macOS/Linux 上一样输入命令——这正是课程官方指南的推荐方案。
参考：课程在 02-write-your-first-program/README.md 中同时给出了 Windows 与 OS X/Linux 两套目录列举命令（
dir与ls），用 Git Bash 后你只需记住 Unix 版本即可。
5.2 打开 Git Bash
- 点击 Windows 开始菜单，搜索 Git Bash；
- 如果桌面有 Git Bash 图标，直接双击打开。
5.3 让 VS Code 默认使用 Git Bash 终端
- 打开 VS Code；
- 打开命令面板（
Ctrl+Shift+P），输入terminal； - 选择 "Terminal: Select Default Profile"（旧版本中名为 "Terminal: Select Default Shell"）；
- 在列表中选择 Git Bash。
此后按 `Ctrl+`` 呼出 VS Code 内置终端时，默认即进入 Git Bash 环境。
5.4 Git Bash 的路径小知识
注意： 在 Windows 资源管理器中，你的文件位于 c:\ 盘；而在 Git Bash 中，同一块磁盘显示为 /c/ 目录。二者指向的是完全相同的目录，只是表示方式不同：
# Git Bash 中访问 C 盘根目录
cd /c/
# 等价于在资源管理器中打开 C:\
类似地，用户目录在 Git Bash 中写作 /c/Users/<你的用户名>。理解这个映射，后续跟随课程在 /c/ 下创建练习目录就不会迷路。
安装完成后：验证环境并运行你的第一个 Go 程序
四步安装 + Git Bash 配置完毕后，建议立即用一段真实的 Go 程序验证整个链路。
验证方式一：克隆本课程仓库
在 Git Bash 中执行：
git clone https://gitcode.com/gh_mirrors/le/learngo.git
cd learngo
若你已拥有该仓库的本地副本，直接
cd进入即可。
验证方式二：运行课程自带的第一段示例程序
本仓库 02-write-your-first-program/main.go 中就有完整的“Hello Gopher”示例，它演示了 package main、import "fmt"、func main() 三个 Go 程序的基本要素。在 Git Bash 中进入该目录后运行：
go run main.go
预期输出：
Hello Gopher!
你还可以参考 02-write-your-first-program/README.md 自己创建并运行第一个程序：
package main
import "fmt"
func main() {
fmt.Println("Hi! I want to be a Gopher!")
}
保存为 main.go 后执行 go run main.go；当目录下有多个 Go 文件时，可以一次运行整个包：
go run .
验证方式三：编译为可执行文件
go build main.go
该命令会在当前目录生成 main.exe（Windows 平台），直接运行它同样会输出程序内容。go build 与 go run 的区别在于：前者只编译生成可执行文件，后者编译并立即执行。课程在 02-write-your-first-program/exercises/01-print-names/solution/main.go 的注释中也演示了这一组合用法。
进阶：关于 GOPATH、Go Modules 与课程仓库
GOPATH 是什么
学习早期 Go 教程时经常会遇到 $GOPATH 的概念。按课程 02-write-your-first-program/questions/01-gopath/README.md 的说明：
- 在旧的 GOPATH 模式下，源码必须放在
$GOPATH/src目录下； - 现代 Go（1.13+，含本仓库 go.mod 声明的 1.13）已经默认启用 Go Modules，源码可以放在任意目录，不再强制要求
$GOPATH/src； - 查看自己的 GOPATH 位置，在 Git Bash 中执行：
go env GOPATH
Windows 上默认输出类似 C:\Users\<用户名>\go。该目录同时是 Go 工具链安装位置（第 4.2 节安装的工具就存放在其 bin 子目录），以及 go install 产物的默认存放地。
使用 Go Modules 运行本仓库
克隆仓库后，在 Git Bash 中执行：
cd learngo
go build ./...
go build ./... 会遍历编译模块下的所有包（本仓库的包分散在 03-packages-and-scopes、06-variables 等各章节目录中），以此确认整个工具链工作正常。仓库依赖的外部模块（如 github.com/fatih/color、github.com/inancgumus/prettyslice 等，见 go.mod）会在首次构建时自动下载——这正是第 2 步安装 Git 的价值所在。
常见问题排查
| 症状 | 可能原因 | 解决办法 |
|---|---|---|
go 不是内部或外部命令 |
Go 未加入 PATH | 检查是否安装了 .msi 且未重开终端；手动把 C:\Program Files\Go\bin 加入系统 PATH 后重开终端 |
VS Code 内终端提示找不到 git |
第 2 步未选 “Use Git from the Windows Command Prompt” | 重装 Git 时勾选该选项，或手动把 Git 的 cmd 目录加入 PATH |
go build ./... 下载依赖失败 |
网络受限或缺少 Git | 确认 Git 已安装且能 git --version；必要时配置代理后再试 |
找不到 C:\ 目录 |
在 CMD 而非 Git Bash 中操作 | 改用 Git Bash，路径写作 /c/ |
| 扩展工具安装一直失败 | 未完全重开 VS Code | 彻底关闭 VS Code 再重新打开后重试 Install/Update Tools |
总结
本指南完整复刻并深化了 01-get-started/windows-installation.md 的四步流程：VS Code → Git（含 Git Bash）→ Go → VS Code Go 工具链，并额外补充了 GOPATH/Go Modules 背景、第一个 Go 程序的运行验证与常见问题排查。完成以上步骤后，你就拥有了运行 learngo 全仓库 1000+ 示例、习题和测验的完整 Windows 开发环境——从现在开始，打开 Git Bash，敲下你的第一行 go run 吧。