如何在 Go 中实现跨包共享常量的正确实践，避免哪些常见误区？

本文共计860个文字，预计阅读时间需要4分钟。

相关专题

go 不支持全局常量，直接使用未加包名前缀的常量（如 `eok`）会损害代码可读性与可维护性；推荐通过明确包路径引用（如 `models.eok`），或结合错误类型封装提升语义表达力。

在 Go 语言中，常量作用域严格受限于包（package）边界，无法像某些动态语言那样定义“全局可见”的符号。你希望在 models 包中定义错误码（如 EOK, EFAILED），并在其他包中不加前缀直接使用 EOK —— 技术上可通过 点导入（dot import） 实现：

import . "models"

此时确实可在当前文件中直接写 EOK 或 EFAILED，无需 models. 前缀。

⚠️ 但强烈不建议这样做。原因如下：

• 命名冲突风险高：若多个包都使用点导入，或当前包自身定义了同名标识符（如 const EOK = 0），编译器将报错 redeclared in this block；
• 可读性严重受损：读者无法快速判断 EOK 来自哪个包，尤其在大型项目中，极大增加理解与调试成本；
• 破坏 Go 的显式设计哲学：Go 强调“清晰胜于简洁”，包名前缀正是体现依赖关系和作用域边界的直观方式。