常见陷阱与解决方案

本模块总结 Go 开发中常见的陷阱和误区，并与 JavaScript 进行对比，帮助你规避常见问题，提升代码质量。

1. 并发编程陷阱

死锁

解决方案

• Go: 使用带缓冲通道或 select，避免无接收方
• JS: 合理使用 Promise/async，避免回调嵌套

竞态条件

解决方案

• Go: 使用 sync.Mutex 或原子操作
• JS: 单线程避免大部分竞态

2. 内存泄漏问题

解决方案

• Go: 及时关闭 channel，避免 goroutine 泄漏
• JS: 注意闭包和事件监听解绑

3. 性能优化误区

• 过早优化，导致代码复杂
• 滥用反射、interface，影响性能
• 忽视内存分配和 GC

最佳实践

• 先保证正确性，再优化性能
• 使用 pprof 分析性能瓶颈
• 合理使用类型和数据结构

4. 错误处理陷阱

解决方案

• Go: 明确处理每个错误，避免忽略
• JS: 合理使用 try-catch，注意异步错误

5. 包管理问题

• Go: go.mod/go.sum 不同步，依赖冲突
• JS: node_modules 冲突、锁文件不一致

最佳实践

• Go: 使用 go mod tidy 保持依赖整洁
• JS: 锁定依赖版本，定期清理

建议结合实际项目多做练习，遇到问题及时查阅官方文档和社区经验。

6. 循环导入 (Circular Imports)

当包 A 导入包 B，而包 B 又导入包 A 时，就会发生循环导入。Go 编译器严格禁止这种情况。

解决方案

• 接口解耦：在一个包中定义接口，由另一个包实现，从而移除直接依赖。
• 第三方包：将共享代码移动到一个公共的第三方包（例如 common 或 types），让 A 和 B 都导入它。

7. JSON 序列化陷阱 (公有/私有字段)

在 Go 中，只有 大写开头（导出）的字段才会被序列化为 JSON。这是习惯了所有属性默认公开的 JS 开发者常遇到的绊脚石。

最佳实践

• 始终将需要序列化的字段首字母大写。
• 使用结构体标签（例如 `json:"name"`）来控制输出的键名（通常是小写）。
• 小写字段实际上是“私有”的，可以防止意外序列化。

8. 变量遮蔽 (Variable Shadowing - := 陷阱)

在块（如 if 或 for）内部使用 := 会创建一个新的局部变量，从而遮蔽外部变量，导致令人困惑的 bug。

解决方案

• 小心使用 :=。如果你想更新现有变量，请使用 =。
• 使用 go vet 或 linter 来检测遮蔽。

9. 切片追加陷阱 (Slice Append Pitfalls)

Go 中的 append 返回一个新的切片描述符。如果你不把它赋值回去，更改就会丢失。此外，多个切片可能共享同一个底层数组，导致意外的副作用。

10. Defer 执行顺序

defer 语句按照 LIFO（后进先出）顺序执行，就像栈一样。

package main
import "fmt"

func main() {
    defer fmt.Println("First")
    defer fmt.Println("Second")
    defer fmt.Println("Third")
    
    fmt.Println("Main body")
}
// 输出:
// Main body
// Third
// Second
// First

11. Goroutine 中的 Panic

如果 goroutine 发生 panic 且未被 recover，整个程序都会崩溃，而不仅仅是那个 goroutine。

解决方案

• 如果你想防止崩溃，请在 goroutine 内部的 defer 块中使用 recover() 来捕获 panic。

12. 未使用的变量和导入

Go 编译器非常严格：未使用的变量和导入是 编译错误。

• JavaScript: Linter 可能会警告，但代码可以运行。
• Go: 代码无法编译。
• 解决方案: 删除它们，或者使用 _（空白标识符）来忽略不需要的值。

13. Nil 接口 vs Nil 具体值

只有当接口的类型和值都为 nil 时，接口才为 nil。存储在接口中的 nil 指针会使接口变为 非 nil。

package main
import "fmt"

type MyError struct{}
func (e *MyError) Error() string { return "My error" }

func main() {
    var err *MyError = nil
    var i interface{} = err
    
    fmt.Println(i == nil) // false! i 的类型是 *MyError，值为 nil
    
    // 这会导致错误检查出现 bug：
    // if err != nil { ... } 即使底层错误是 nil，这里也可能为 true
}