Go 的编译错误往往不算“难懂”，难的是第一次看到时抓不住重点：到底是名字没声明、类型没对上，还是模块路径出了问题。把常见报错按触发场景拆开后，排查顺序会清楚很多；读完这篇，你可以先凭报错字面判断问题类别，再决定该去查变量、函数签名、返回值还是模块配置。
名称未定义与类型不匹配
undefined: xxx
undefined: xxx 是最常见的一类，意思很直接：编译器在当前位置找不到这个名字。这里的 xxx 可能是变量、常量、函数，也可能是你以为已经声明过的其他标识符。
出现这类错误时，优先检查几件事：是不是拼写写错了、大小写不一致、声明位置不在当前作用域内，或者变量声明了但根本还没初始化。很多时候问题并不复杂，只是名字和你想象的不一致。
cannot use xxx (type xxx) as type yyy in argument
cannot use xxx (type xxx) as type yyy in argument 说明参数类型不匹配。你传进去的是一种类型，但函数、方法或接口此处要求的是另一种类型。
这类报错的关键不是盯着调用处发愣，而是回头看函数签名。先确认参数声明的目标类型，再对照实参的实际类型，看是需要转换、调整变量定义，还是你本来就调用错了函数。
type xxx is not an expression
type xxx is not an expression 表示你把“类型”当成了“值”在使用。Go 里类型名本身不是表达式，不能直接拿来当运行时的值处理。
比如写 int(3) 是合法的类型转换，但如果直接把 int 当成一个值来参与赋值或计算，就会触发这类错误。遇到这条信息时，重点看你写下的到底是类型、变量，还是某个构造表达式。
语法错误与返回值使用错误
syntax error: unexpected xxx, expecting yyy
syntax error: unexpected xxx, expecting yyy 属于语法解析错误。编译器在当前位置读到了一个“不该出现”的标记，同时也告诉你它原本期待看到什么。
这种报错经常和括号、花括号、逗号的位置有关，也可能是某一行少了必要的结构，导致后面的 token 全部被“带歪”。排查时不要只盯报错所在那一行，往前多看几行，通常能更快找到真正缺失或写错的符号。
multiple-value xxx() in single-value context
multiple-value xxx() in single-value context 表示函数返回了多个值，但当前上下文只允许接收一个值。这在 Go 里很常见，因为很多函数都会同时返回结果和错误。
例如你写了 val := someFunc()，但 someFunc 实际返回两个值，那么编译器就会报错。正确做法通常是按返回值个数接收，或者用 _ 忽略不需要的部分。
val, err := someFunc()
_ = err如果你明知函数会返回多个值，就应该先检查当前赋值、传参或表达式位置是否只接受单值。
包解析失败与导入未使用
cannot find package "xxx" in any of
cannot find package "xxx" in any of 说明依赖包没有被正确找到。问题可能出在模块没拉下来、包路径写错，或者本地环境里的模块配置不对。
遇到这类报错，通常先检查是否执行过 go mod tidy 或 go get，再确认 GOPATH、GOROOT 和模块路径是否一致。尤其是在老项目、新模块模式、私有仓库混用时，这类错误特别常见。
go mod tidy
go getimported and not used: xxx
imported and not used: xxx 表示包已经导入，但代码里没有真正使用它。Go 对未使用导入比较严格，这不是警告，而是会直接阻止编译通过。
如果这个包确实没用，就直接删除；如果你是为了触发副作用导入，例如注册驱动或初始化某些能力，需要使用 _ 别名来明确表达意图。保持导入列表干净，本身也是减少误判和阅读成本的一部分。
读懂 Go 报错时，先按类别再定位细节
从日常开发经验看，以上几类已经覆盖了大部分 Go 编译报错。真正提高排查效率的方法，不是见错就搜，而是先根据报错句式判断它属于哪一类：是标识符不存在、类型不一致、语法结构损坏、返回值数量不符，还是模块与导入问题。
一旦分类明确，定位范围会立刻缩小。比如看到 undefined 就先查声明和作用域，看到 cannot use 就去看函数签名，看到 multiple-value 就查返回值接收方式，看到 cannot find package 就检查模块和环境。很多时候，错误信息本身已经把方向告诉你了，差别只在于你有没有按它的提示去读。
