go version 命令找不到，主因是path未生效或powershell执行策略拦截；需检查$env:path是否含go\bin路径，并运行set-executionpolicy remotesigned -scope currentuser临时放行。

go version 命令找不到？先查 PATH 和执行策略

不是安装失败，是 PowerShell 拒绝执行或根本没认到 go。Windows 上最常卡在这一步：双击 MSI 安装完，go version 报 command not found。

原因有两个：一是 %GOROOT%\bin 没加进系统 PATH；二是 PowerShell 默认禁止运行本地脚本，go 的 wrapper 脚本（比如 Chocolatey 安装的）可能被拦截。

• 手动检查 PATH：在 PowerShell 里运行 $env:PATH -split ";" | Select-String "Go"，看是否含 C:\Program Files\Go\bin 或你自定义的路径
• 临时绕过执行策略：运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户，不需管理员）
• 别依赖“安装完成自动配置”：MSI 不写入用户级 PATH，Chocolatey 有时也不触发 profile 重载，关掉所有终端再新开一个

GOPATH 初始化失败？Go Modules 已默认启用，但旧项目仍会踩坑

go: cannot find main module 这类报错，90% 是因为你在非模块根目录下执行 go run，而不是 GOPATH 没设对。Go 1.16+ 默认开启 GO111MODULE=on，GOPATH 只影响 $GOPATH/bin 下的可执行文件存放位置，不影响模块查找逻辑。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 新建项目必须先 go mod init example.com/myapp，生成 go.mod 文件后再 go run .
• 如果项目已有 go.mod，但提示找不到模块，检查当前目录是否在 go.mod 所在目录或其子目录内——不能跨父目录调用
• 旧项目从 GOPATH 切换过来时，src/ 目录结构不再必需，但 go install 生成的二进制仍默认放 $GOPATH/bin，记得把它加入 PATH

Docker 容器里 go mod download 失败？缺的是 ca-certificates，不是 Go 本身

官方 golang:1.26 镜像跑 go mod download 报 x509: certificate signed by unknown authority，不是代理或网络问题，是镜像精简掉了证书信任库。

• Debian 系基础镜像要补：apt-get update && apt-get install -y ca-certificates
• Alpine 镜像对应命令是：apk add --no-cache ca-certificates
• 别漏掉 update-ca-certificates（Debian）或 update-ca-bundle（Alpine），否则新装证书不生效
• 挂载宿主机 /etc/ssl/certs 是权宜之计，容器重启后证书路径可能失效，优先走包管理器安装

VS Code 调试器启动失败？dlv 二进制不在 $PATH 或权限不对

F5 启动调试时报 Delve not found 或 permission denied，不是插件没装，而是 dlv 没正确安装或没被识别。

• 在容器或 WSL 中开发时，go install github.com/go-delve/delve/cmd/dlv@latest 必须在目标环境里执行，不能只在宿主机装
• PowerShell 下用 go install 生成的 dlv.exe 默认放 $GOPATH/bin，确认该路径在 $env:PATH 中
• Windows Defender 有时会把刚编译的 dlv.exe 当可疑程序隔离，检查安全中心“病毒和威胁防护→保护历史记录”

实际环境里最麻烦的从来不是“怎么装”，而是多个路径变量（GOROOT、GOPATH、GOBIN、PATH）在不同 shell、不同用户上下文、不同容器命名空间里各自生效又互相覆盖。每次出问题，先 go env，再 which go（WSL/macOS）或 Get-Command go（PowerShell），最后比对输出里的路径是否真实存在且可执行——跳过这三步，后面所有操作都是蒙眼配钥匙。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！