根本不是Go没装，是go命令没进PATH：Windows需在系统属性环境变量中添加GOROOT\bin，macOS/Linux须将/usr/local/go/bin写入~/.zshrc或~/.bash_profile并source，所有平台改完后必须新开终端或重启VS Code验证。
go version 报 command not found 怎么办
根本不是 Go 没装，是 go 命令没进 PATH。Windows 用户别信安装器勾选的“添加到 PATH”——它只改了当前会话的临时变量，重启终端或手动刷新环境才生效；macOS/Linux 用户执行 source ~/.zshrc（或 ~/.bash_profile）后仍无效，说明安装路径（如 /usr/local/go/bin）根本没写进配置文件。
验证方式：运行 which go（macOS/Linux）或 Get-Command go（PowerShell），无输出即失败。
- Windows：去「系统属性 → 高级 → 环境变量」，确认
C:\Program Files\Go\bin（或你自定义的GOROOT\bin）已加入用户或系统 PATH - macOS/Linux：检查
~/.zshrc或~/.bash_profile末尾是否含export PATH=$PATH:/usr/local/go/bin；统信UOS用户若用 APT 安装，go通常在/usr/bin/go，无需额外加 PATH - 所有平台：改完配置后必须新开终端，或在当前终端执行
source命令，否则不生效
go mod init 失败或生成错误 module 名
常见现象是运行 go mod init 后，go.mod 里 module 名变成 example.com/xxx 或空字符串，甚至报错 cannot determine module path。本质是当前目录仍在 GOPATH/src 下，Go 会按旧路径推导 module 名，而不是你期望的项目名。
解决方法非常直接：别在 $GOPATH/src 里初始化项目。
- 先执行
echo $GOPATH（macOS/Linux）或echo %GOPATH%（Windows），确认GOPATH路径 - 切到任意非
$GOPATH/src的目录，比如~/projects/myapp，再运行go mod init myapp - 删掉项目根目录下残留的
vendor/目录（除非你明确要 vendor 依赖） - 运行
go env -w GO111MODULE=on强制启用模块模式，避免老脚本或 CI 环境关掉了它
go build 编译出的可执行文件名怎么控制
go build 默认行为取决于上下文：单独编译 main.go 得到 main（或 main.exe）；在有 go.mod 的项目根目录下运行，则默认输出文件名是 go.mod 中 module 行声明的名字。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
想指定名字，必须用 -o 参数，且路径需写全（包括扩展名）：
-
go build -o hello→ 输出hello（Linux/macOS）或hello.exe（Windows） -
go build -o ./dist/app→ 输出到dist/目录，文件名是app（自动补.exe） -
go build -o app.exe→ 显式指定 Windows 可执行名，Linux/macOS 下也会生成app.exe文件（但不可直接运行） - 注意：
go build -o app不会覆盖已存在的app，而是静默失败，终端无提示——这是容易忽略的坑
VS Code 里 gopls 启动失败或没代码提示
不是插件没装对，是 gopls 这个语言服务器启动依赖三个硬条件：终端能调用 go 命令、当前打开的是模块根目录（含 go.mod）、文件后缀是 .go。缺一不可。
典型表现：编辑器右下角显示 “Loading…” 卡住，或保存时无格式化反应。
- 先在 VS Code 内置终端运行
go version，失败说明PATH在 VS Code 启动时未加载（macOS/Linux 常见，需在~/.zshrc里配置，而非仅终端生效） - 确认当前工作区根目录有
go.mod；没有就go mod init example.com/myapp - 检查文件是否以
.go结尾，且包声明是package main（非package xxx_test） - 国内用户若
gopls下载慢或失败，需提前设置代理：go env -w GOPROXY=https://goproxy.cn,direct
最常被跳过的动作：改完环境变量后没重启 VS Code。它不会动态重读 shell 配置，必须完全退出再打开。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
