Windows环境下Go语言的官方安装与配置指南-Golang-PHP中文网

Windows环境下Go语言的官方安装与配置指南

聖光之護

发布： 2025-08-18 15:26:13

原创

675人浏览过

Windows环境下Go语言的官方安装与配置指南

本教程旨在为Windows用户提供Go语言的完整安装与环境配置指南。文章详细介绍了从官方渠道下载安装包、执行安装程序、验证安装、配置必要的环境变量，直至运行第一个Go程序的全过程。通过遵循本指南，用户可以确保Go语言开发环境的正确搭建，为后续的Go语言学习与开发奠定坚实基础。

在windows系统上安装go语言，最推荐且最稳定的方式是使用官方提供的msi安装程序。请务必从go语言官方网站下载最新版本的安装包，以确保兼容性和安全性。

访问官方下载页面： 打开浏览器，访问 Go语言官方下载页面。
选择适合的版本： 在下载页面中，找到“Featured downloads”部分，选择适用于Windows系统的安装包。通常，您会看到 goX.Y.Z.windows-amd64.msi（适用于64位系统）或 goX.Y.Z.windows-386.msi（适用于32位系统）。根据您的操作系统架构选择对应的MSI文件。

下载完成后，按照以下步骤执行安装：

运行安装程序： 双击下载的 .msi 安装文件（例如 go1.22.1.windows-amd64.msi）。
接受许可协议： 在安装向导中，阅读并接受Go语言的许可协议。
选择安装路径： 默认情况下，Go语言会被安装到 C:\Program Files\Go\ 目录下。建议保持默认路径，除非您有特定需求。点击“Next”继续。
完成安装： 点击“Install”开始安装过程。安装可能需要几分钟。完成后，点击“Finish”退出安装向导。

安装程序通常会自动配置Go语言的环境变量（包括 GOROOT 和 PATH）。为了确认Go语言是否已成功安装并可执行，您需要打开命令提示符或PowerShell进行验证。

打开命令提示符/PowerShell：
- 在Windows搜索栏中输入 cmd 并按回车键，或输入 PowerShell 并按回车键。
执行验证命令： 在打开的终端窗口中，输入以下命令并按回车键：
```
go version
```
登录后复制
检查输出： 如果安装成功，您将看到类似以下的输出，显示当前安装的Go语言版本信息：
```
go version go1.22.1 windows/amd64
```
登录后复制
如果出现“'go' 不是内部或外部命令，也不是可运行的程序或批处理文件”的错误，则表示环境变量可能没有正确配置，需要手动检查或配置（详见下一节）。

尽管官方安装程序会自动处理环境变量，但了解其配置原理有助于在遇到问题时进行排查，或进行自定义设置。

Go语言主要涉及两个重要的环境变量：

GOROOT: 指向Go语言的安装根目录，例如 C:\Program Files\Go\。通常由安装程序自动设置。
GOPATH: 这是Go语言工作区（Workspace）的路径，用于存放您的Go项目代码、第三方包以及编译生成的可执行文件。从Go 1.11版本开始，Go模块（Go Modules）的引入使得 GOPATH 的重要性降低，项目可以位于文件系统的任何位置。但对于旧项目或特定工作流，了解 GOPATH 仍然有益。默认情况下，GOPATH 通常设置为用户主目录下的 go 文件夹（例如 C:\Users\YourUser\go）。

检查和手动配置环境变量：

打开系统属性：
- 右键点击“此电脑”（或“我的电脑”），选择“属性”。
- 点击“高级系统设置”。
- 在“系统属性”窗口中，点击“环境变量”按钮。
查看或编辑环境变量：
- 在“系统变量”或“用户变量”中查找 Path 变量。确保其中包含Go语言的 bin 目录路径（例如 C:\Program Files\Go\bin）。这是 go 命令能够被识别的关键。
- 您也可以在此处查看或设置 GOPATH 变量（通常在“用户变量”中）。如果您需要自定义工作区路径，可以在这里添加或修改。
- 注意： 对于Go Modules项目，通常无需手动设置 GOPATH，Go会自动在项目根目录下的 go.mod 文件中管理依赖。

Go语言环境搭建完成后，我们可以编写并运行一个简单的“Hello, World!”程序来进一步验证。

创建项目目录： 在您喜欢的任何位置创建一个新的文件夹，例如 C:\Users\YourUser\go_projects\hello。

CreateWise AI
为播客创作者设计的AI创作工具，AI自动去口癖、提交亮点和生成Show notes、标题等

133

查看详情
创建Go源文件： 在 hello 文件夹内，创建一个名为 main.go 的文件，并使用文本编辑器（如记事本、VS Code等）打开，输入以下代码：
```
package main

import "fmt"

func main() {
    fmt.Println("Hello, Go on Windows!")
}
```
登录后复制
初始化Go模块（推荐）： 打开命令提示符或PowerShell，导航到 hello 目录：
```
cd C:\Users\YourUser\go_projects\hello
go mod init hello_app
```
登录后复制
这会创建一个 go.mod 文件，表示这是一个Go模块项目。
运行程序： 在同一终端窗口中，执行以下命令：
```
go run main.go
```
登录后复制
您应该会看到输出：
```
Hello, Go on Windows!
```
登录后复制
这表明您的Go语言环境已完全准备就绪，可以开始开发了。

管理员权限： 在安装Go语言时，建议以管理员身份运行安装程序，以确保所有文件和环境变量都能正确设置。
32位 vs 64位： 务必根据您的Windows系统架构选择对应的安装包。大多数现代Windows系统都是64位（amd64）。
防火墙或杀毒软件： 有些防火墙或杀毒软件可能会阻止Go安装程序或Go程序的正常运行。如果遇到问题，尝试暂时禁用它们。
Go版本更新： 要更新Go语言版本，只需下载新版本的MSI安装程序并运行即可。它会自动覆盖旧版本并更新环境变量。
使用官方源： 始终从 golang.org/dl 下载Go语言安装包，避免使用第三方或非官方的发行版，以确保安全性和稳定性。
IDE/编辑器集成： 安装Go语言后，您可以选择安装Go插件或扩展到您喜欢的集成开发环境（IDE）或代码编辑器中，如Visual Studio Code、GoLand等，以获得更好的开发体验。