go version报错或显示旧版本，本质是path未包含go的bin目录或旧版本残留干扰；windows需检查path是否含c:\go\bin，macos/linux需确认shell配置中export path=$path:/usr/local/go/bin且已source生效。
go version 命令报错或显示旧版本
说明：安装后执行 go version 报错（如 command not found）或显示非预期版本（比如系统自带的 1.13），本质是 PATH 没包含 Go 的 bin 目录，或旧版本残留干扰。
- Windows 用户检查系统环境变量
Path是否包含C:\Go\bin（默认安装路径）；若改过安装目录，需填入实际路径，例如D:\Go\bin - macOS/Linux 用户确认 shell 配置文件（
~/.zshrc或~/.bash_profile）中已写入export PATH=$PATH:/usr/local/go/bin，且执行过source ~/.zshrc - 若曾用包管理器（如
brew install go）装过旧版，先运行brew uninstall go，再清理/usr/local/bin/go等残留二进制文件 - 验证方式：在新终端窗口中直接运行
which go，应输出有效路径；再跑go version看是否为官网下载的最新稳定版（当前是go1.22.0或更高）
GOPATH 和 GO111MODULE 设置不生效
说明：go mod init 失败、依赖无法下载、或提示 cannot find module providing package，大概率是模块模式没真正启用，或工作区路径混乱。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
GO111MODULE=on必须显式开启——即使 Go 1.16+ 默认启用，某些旧 shell 配置或 CI 环境仍可能 fallback 到auto模式。建议统一用go env -w GO111MODULE=on -
GOPATH不再强制要求，但若设了，必须是**非/usr/local/go或C:\Go这类安装路径本身**，否则会触发奇怪的缓存冲突；推荐设为$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows） - 新建项目时，务必在**空目录下**执行
go mod init example.com/myapp，不要在$GOPATH/src下操作——那是 GOPATH 模式的老习惯，模块模式下完全不需要 - 国内用户务必配代理：运行
go env -w GOPROXY=https://goproxy.cn,direct，否则go get会卡死或超时
go run hello.go 却提示 “package main is not a main package”
说明：这不是环境问题，而是代码结构错误。Go 要求可执行程序必须满足两个硬性条件：包名是 main，且包含 func main() 函数。
- 检查文件开头是否为
package main—— 写成package myapp或漏掉这一行都会失败 - 检查是否有且仅有一个
func main()，且它必须在main包内；不能放在其他包里，也不能拼错成Func Main()或func Main() - 确保文件扩展名是
.go，且没有隐藏字符（比如 Windows 记事本可能加 BOM 头，建议用 VS Code 或vim编辑） - 如果项目含多个
.go文件，全部都要在main包里，且只能有一个main函数；否则编译器会报重复定义
VS Code 中调试/补全失效，提示 “No workspace detected”
说明：Go 插件依赖正确的 workspace 结构和 go.mod 文件来激活语言服务，纯文件夹打开不等于 Go 工程。
- 不要直接打开一个空文件夹写
hello.go；先在终端 cd 进目标目录，运行go mod init example.com/hello生成go.mod - VS Code 打开的是该目录（即含
go.mod的根目录），不是某个单文件 - 确认已安装官方 Go 插件（作者：Go Team at Google），并重启 VS Code；插件会自动下载
dlv（调试器）和gopls（语言服务器），首次可能较慢 - 若仍无补全，右键编辑器空白处 → “Go: Install/Update Tools”，勾选全部工具（尤其
gopls），点击 OK
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
