一、安装 Go

  1. 下载 Go 安装包

    • 访问 Go 官方网站:https://golang.org/dl/
    • 选择适合 Windows 的最新稳定版本。
    • 下载 .msi 安装文件,例如 go1.21.7.windows-amd64.msi
  2. 运行安装程序

    • 双击下载的 .msi 文件,按照提示安装。
    • 默认安装路径为:C:\Program Files\Go(建议保持默认)。
    • 安装完成后,Go 的二进制文件会位于 C:\Program Files\Go\bin
  3. 验证安装

    • 打开命令提示符(按 Win + R,输入 cmd,回车)。

    • 输入以下命令检查版本:

      go version
      
    • 如果显示类似 go version go1.21.7 windows/amd64,说明安装成功。


二、配置环境变量

Windows 上需要配置环境变量,以便在任何目录下都能使用 go 命令。

  1. 检查默认环境变量

    • Go 的安装程序通常会自动将 C:\Program Files\Go\bin 添加到系统 PATH 中。

    • 在命令提示符中运行 go env 检查:

      • GOEXE 应为 .exe
      • GOPATH 默认是 %USERPROFILE%\go(如 C:\Users\你的用户名\go)。
  2. 手动配置(若未自动添加)

    • 右键“此电脑” > “属性” > “高级系统设置” > “环境变量”。

    • 在“系统变量”下的 Path 中,点击“编辑”,添加:

      C:\Program Files\Go\bin
      
    • 点击“确定”保存。

  3. 设置 GOPATH(可选)

    • GOPATH 是 Go 工作目录,用于存放源码、依赖和编译结果。

    • 默认值为 %USERPROFILE%\go,若想自定义:

      • 在“用户变量”中新增变量:

        • 变量名:GOPATH
        • 变量值:D:\GoProjects
    • 验证:重启命令提示符,运行 go env GOPATH,应显示你设置的路径。

  4. 验证环境变量

    • 重启命令提示符,运行:

      go env
      
    • 检查 GOROOT(Go 安装路径,如 C:\Program Files\Go)和 GOPATH 是否正确。


三、安装必备工具

  1. 安装 Git

    • Go 依赖 Git 来下载模块。
    • 下载地址:https://git-scm.com/download/win
    • 安装后,确保 git --version 可在命令行运行。
  2. 代码编辑器

    • 推荐使用 Visual Studio Code(VS Code):

      • 下载:https://code.visualstudio.com/

      • 安装 Go 扩展:

        1. 打开 VS Code,按 Ctrl + Shift + X 打开扩展市场。
        2. 搜索 Go(由 Go Team 开发),点击安装。
        3. 安装后,按 Ctrl + Shift + P,输入 Go: Install/Update Tools,选择并安装所有推荐工具(如 gopls)。
  3. 终端(可选)

    • 默认使用 cmd,但推荐安装更强大的终端:

      • Windows Terminal:微软商店下载。
      • PowerShell:Windows 自带。

四、测试 Go 环境

  1. 创建第一个 Go 项目

    • 创建工作目录:

      mkdir D:\GoProjects\hello
      cd D:\GoProjects\hello
      
    • 初始化模块(Go 1.11+ 使用模块化管理):

      go mod init hello
      
  2. 编写代码

    • 创建 main.go 文件:

      package main
      
      import "fmt"
      
      func main() {
          fmt.Println("Hello, Go on Windows!")
      }
      
    • 保存文件。

  3. 运行程序

    • 在命令行运行:

      go run main.go
      
    • 输出:Hello, Go on Windows!

  4. 编译程序

    • 编译为可执行文件:

      go build
      
    • 生成 hello.exe,双击运行或在命令行输入 hello 执行。


五、常见问题与解决

  1. 命令 go 未找到

    • 检查 Path 是否包含 C:\Program Files\Go\bin
    • 重启命令提示符或电脑。
  2. 模块下载失败

    • 设置代理(若在中国大陆):

      go env -w GOPROXY=https://goproxy.cn,direct
      
    • 确保 Git 已安装。

  3. VS Code 提示缺少工具

    • 运行 go mod tidy 下载依赖。
    • 在 VS Code 中重新安装 Go 工具(Go: Install/Update Tools)。

六、进阶配置(可选)

  1. 设置 GOBIN

    • 默认编译的可执行文件放在 GOPATH/bin,可自定义:

      go env -w GOBIN=D:\GoProjects\bin
      
    • 添加 D:\GoProjects\binPath

  2. 启用 Go Modules

    • Go 1.11+ 默认支持模块化,无需 GOPATH 即可开发。
    • 每个项目运行 go mod init <module-name> 初始化。
  3. 安装常用工具

    • 格式化:go fmt(内置)。
    • 静态分析:go install golang.org/x/lint/golint@latest
    • 依赖管理:go get

七、开发环境验证

  • 创建一个简单 HTTP 服务器测试完整性:

    package main
    
    import (
        "fmt"
        "net/http"
    )
    
    func main() {
        http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
            fmt.Fprintf(w, "Welcome to Go on Windows!")
        })
        fmt.Println("Server running at http://localhost:8080")
        http.ListenAndServe(":8080", nil)
    }
    
  • 运行:go run main.go

  • 打开浏览器访问 http://localhost:8080,应显示欢迎消息。