Learngo 项目 Windows 环境搭建指南：VS Code、Git、Go 与 Git-Bash 全流程安装与配置

本指南面向在 Windows 系统上准备学习 learngo（1000+ 手工编写的 Go 示例、练习与测验）的开发者，系统讲解从零搭建 Go 开发环境的完整流程：包括 Visual Studio Code 编辑器的安装、Git 的安装与选项选择、Go 工具链的安装、VS Code 的 Go 扩展与工具链配置，以及如何使用 Git-Bash 作为与课程（Unix/Linux 风格）一致的命令行环境。读完本文，你将获得一套可立即运行仓库中任意 .go 示例的 Windows 开发环境，并能用 go run、go build 验证学习进度。

本指南对应的原始文档为 translation/spanish/01-empecemos/instalacion-windows.md，其英文原版见 01-get-started/windows-installation.md，是西班牙语版课程《01-empecemos》（开始吧）的安装章节；同一系列的还有 instalacion-osx.md 与 instalacion-ubuntu.md，可参见 01-empecemos 目录。

安装清单总览

在动手之前，先明确本指南将依次完成的任务，全部步骤均可离线操作，无需额外联网工具：

步骤	目标	关键产物
1	安装 Visual Studio Code 编辑器	VS Code（暂不打开）
2	安装 Git（含 Git-Bash）	Git 命令行、Git-Bash 终端
3	安装 Go 工具链	go、gofmt、go doc 等命令
4	配置 VS Code 的 Go 扩展与工具	Go 扩展 + 全部辅助工具
5	在 VS Code 中启用 Git-Bash	与课程一致的终端环境

可选捷径：如果你已安装 Chocolatey 包管理器（Windows 上的包管理工具，类似 Linux 的 apt），可以直接用一条命令安装 Go，从而跳过第 3 步的大部分手动操作。详见下文「捷径：用 Chocolatey 安装 Go」。

捷径：用 Chocolatey 安装 Go

如果你已经拥有 Chocolatey 包管理器，可以非常简单地安装 Go：

choco install golang

在管理员权限的 PowerShell 或命令提示符中执行该命令即可。Chocolatey 会自动下载官方 Go 安装包并完成安装、环境变量配置等操作，之后你仍可按本指南继续安装 VS Code 与 Git，并完成 VS Code 的 Go 工具配置。

需要注意：这种方式安装的是系统级环境，安装完成后建议重新打开终端（或重启 VS Code），确保 go 命令进入 PATH。

第 1 步：安装 Visual Studio Code 编辑器

1. 前往 Visual Studio Code 官方网站（code.visualstudio.com）；
2. 选择 Windows 版本并开始下载；
3. 运行安装程序；
4. 安装完成后暂时不要打开 VS Code——按原文档的建议，我们要先装好 Git 和 Go，再统一配置编辑器，避免重复重启。

原文档特意强调「安装但先别打开」，是因为后续第 4 步需要在 VS Code 中安装 Go 扩展并安装全部 Go 工具，而这些工具依赖 go 命令可用；先装好 Go 再打开 VS Code，配置流程会更顺畅。

第 2 步：安装 Git（含 Git-Bash）

Git 在本课程中有双重作用：一是作为版本管理工具（可用来克隆本仓库），二是提供 Git-Bash 这个 Unix 风格的终端，用于与课程中的 bash 命令保持一致。原文档中的选项勾选对后续体验影响很大，请逐项对照：

1. 前往 Git for Windows 官网（gitforwindows.org），下载并运行安装程序；
2. 选择 VSCode 作为默认编辑器——这样 Git 在需要编辑提交信息时会自动调用 VS Code；
3. 勾选所有复选框——包括 Git LFS、关联 .git 配置文件等默认增强选项，全部保持勾选即可；
4. 调整 PATH 环境变量时，选择 「Use Git from the Windows Command Prompt」（从 Windows 命令提示符使用 Git）。该选项会把 Git 及其工具加入系统 PATH，使 Git-Bash 可以被 VS Code 等程序发现；
5. 在行结束符（line ending）转换设置中，选择 「Checkout as is, commit as is」（按原样检出，按原样提交），避免 Windows 与 Linux/Unix 之间的 CRLF/LF 转换造成源码内容差异。

第 4 步选择「Use Git from the Windows Command Prompt」是后续 VS Code 能直接识别并调用 Git-Bash 的关键前提；第 5 步选择「按原样检出/提交」可以防止 Go 源码文件在克隆后被转换行结束符，进而避免一些与字符串、注释解析相关的意外差异。

第 3 步：安装 Go 工具链

1. 前往 Go 官方下载页（golang.org/dl）；
2. 选择 Windows 版本（根据你的系统架构选择 amd64 或 arm64 安装包），下载；
3. 运行安装程序，使用默认安装路径即可（默认安装在 C:\Program Files\Go）。

安装完成后，务必重新打开一个新的终端窗口（或重启电脑），然后验证安装是否成功：

go version

如果输出形如 go version go1.x.x windows/amd64，说明 Go 已正确安装并进入 PATH。当前仓库的 go.mod 声明 go 1.13，并依赖 github.com/fatih/color、github.com/inancgumus/prettyslice、github.com/inancgumus/screen 等第三方包，因此建议安装 1.13 或更高版本的 Go，以保证仓库内代码与依赖均可正常构建。

第 4 步：配置 Visual Studio Code 的 Go 开发环境

装好 VS Code 与 Go 之后，开始配置编辑器：

1. 打开 VS Code，点击左侧的**扩展（Extensions）**标签页，搜索 go，安装由 Go 官方团队维护的 Go 扩展（发布者为 golang.go）；
2. 完全关闭 VS Code，再重新打开——让扩展加载并识别刚才安装的 Go 工具链；
3. 打开「查看（View）」菜单，选择命令面板（Command Palette），或直接按下快捷键 Ctrl+Shift+P；
4. 在命令面板中输入 go install；
5. 选择 「Go: Install/Update Tools」 命令；
6. 在弹出的工具列表中勾选所有复选框，然后点击确定进行安装。

「Go: Install/Update Tools」会为 VS Code 的 Go 扩展安装一系列配套命令行工具，包括但不限于：代码格式化（gofmt/goimports）、静态检查（staticcheck）、调试器（dlv）、补全与符号跳转（gopls）等。勾选全部并安装后，你在编辑器中就能获得语法高亮、自动补全、错误提示、go run/go build 一键执行等完整开发体验，这也是本仓库大量示例代码（如 02-write-your-first-program/main.go）能被顺畅阅读与修改的基础。

第 5 步：使用 Git-Bash 作为课程终端

本课程中的命令示例统一使用 bash 语法。bash 是 OS X 与 Linux 上最流行的命令行界面之一。原文档明确指出：课程会持续使用 bash 命令，因为 bash 支持更高级的命令组合与管道操作。如果你的默认终端是 Windows 的命令提示符（cmd）或 PowerShell，则推荐改用随 Git 一起安装的 Git-Bash，这样你敲出的命令与课程示例完全一致。

启动 Git-Bash

1. 在开始菜单的搜索栏中搜索 git bash 并打开；
2. 或者，如果桌面上有 Git-Bash 图标，直接双击打开。

让 VS Code 默认使用 Git-Bash

1. 打开 VS Code；
2. 打开命令面板（Ctrl+Shift+P）；
3. 输入 terminal；
4. 选择 「Terminal: Select Default Profile / Terminal por Defecto」（选择默认终端）;
5. 在列表中选择 「Git Bash」。

设置完成后，VS Code 内置终端（Ctrl+`）将默认以 Git-Bash 启动，后续所有课程命令都可以直接在此输入。

路径写法差异：c:\ vs /c/

这是 Windows 初学者最容易困惑的一点。原文档特别提醒：

在 Windows 下你通常通过 c:\ 访问文件；但使用 Git-Bash 时，同一个目录写作 /c/。它本质上是同一个目录，只是更简短的表示方式。

例如，你的用户主目录在 cmd 中写作 C:\Users\你的用户名，在 Git-Bash 中则写作 /c/Users/你的用户名。理解这一对应关系后，你就能在 Git-Bash 中自由使用 cd、ls、mkdir 等 Unix 风格命令。

更强大的备选：Windows 上的 Linux 子系统（WSL）

如果你希望获得比 Git-Bash 更接近 Linux 的完整环境，可以使用 Windows 上的 Linux 子系统（WSL）。WSL 提供一个真正的 Linux 发行版运行环境，bash 能力更完整。当然，对于本课程的学习目标而言，Git-Bash 已经足够——原文档也强调「如果不想用 Git-Bash 也没关系，取决于你，只是课程中会大量使用 bash 命令」。

安装完成后的验证：运行你的第一个 Go 程序

按照原文档，环境配置好之后就可以开始写第一个程序了。仓库的 02-write-your-first-program/README.md 提供了从命令行创建并运行第一个 Go 程序的完整速查：

1. 创建目录并进入：

   mkdir myDirectoryName
   cd myDirectoryName
   

2. 在 VS Code 中创建 main.go 文件，写入以下代码：

   package main
   
   import "fmt"
   
   func main() {
       fmt.Println("Hi! I want to be a Gopher!")
   }
   

3. 回到命令行（Git-Bash），运行程序：

   go run main.go
   

   如果目录中有多个文件需要一起运行，可以使用：

   go run .
   

4. 构建可执行文件（Windows 下会生成 .exe）：

   go build main.go
   

仓库还提供了更丰富的入门素材：带注释的完整示例见 02-write-your-first-program/main.go（其中注释演示了 fmt.Println、包导入、注释与 Unicode 字符串等概念）；配套练习见 02-write-your-first-program/exercises/README.md，其中包含一个与 Windows 直接相关的进阶练习——跨操作系统编译：

# 在 Windows 上生成 Windows 可执行文件
GOOS=windows GOARCH=386 go build

# 生成 OS X (darwin) 可执行文件
GOOS=darwin GOARCH=386 go build

# 生成 Linux ARM 可执行文件
GOOS=linux GOARCH=arm GOARM=7 go build

注意：在 cmd 或 PowerShell 中设置环境变量需要不同的语法，例如 cmd /c "set GOOS=darwin GOARCH=386 && go build"；而 Git-Bash 中可直接使用上述 GOOS=... GOARCH=... 前缀写法。这正是课程推荐使用 Git-Bash 的又一个实际理由。

常见问题与提示

• go 命令找不到：通常是安装 Go 后没有重启终端，或安装时未勾选加入 PATH。重新打开终端（或重启系统）后再次执行 go version。
• VS Code 中 Go 扩展提示工具未安装：重新打开命令面板，再次执行「Go: Install/Update Tools」，勾选全部工具安装。
• Git 安装时忘了选择「Use Git from the Windows Command Prompt」：可重新运行 Git 安装程序，或在系统 PATH 中手动加入 Git 的 cmd 目录；更简单的做法是按原文档重新执行安装并勾选全部选项。
• 文件路径总是报错：检查是否混淆了 c:\... 与 /c/... 两种写法；在 Git-Bash 中统一使用 /c/... 形式。
• 克隆仓库后运行示例报缺少依赖：确保 Go 版本不低于 go.mod 中声明的 1.13，并在对应目录下执行 go mod download 拉取依赖（go.sum 已随仓库提供锁定版本）。

一切就绪后，就可以开始逐一运行仓库中 1000+ 个手写 Go 示例、练习与测验，从 01-get-started（安装指南汇总）一路学到 02-write-your-first-program 乃至更深入的主题了。祝学习愉快！