Go函数命名必须首字母大小写决定可见性:大写导出(如NewClient)、小写私有(如parseURL),禁用下划线,特有名词保持原形,接口方法同理。

Go函数命名必须用驼峰式、首字母大小写决定可见性,没有例外。这不是风格偏好,而是语言机制——首字母小写 = 包内私有,大写 = 可被其他包导入调用。别想用下划线、中划线或混合大小写绕开它。
公有函数必须首字母大写 + 动词开头
导出函数(即能被其他包调用的)必须以大写字母开头,且推荐用动词或动词短语表达行为,比如 NewClient、ParseJSON、ValidateEmail。不能写成 new_client 或 parse_json,Go 会直接报错“unexported name”。
- ✅ 正确:
OpenFile、EncodeToString、IsTimeout - ❌ 错误:
open_file、encode_to_string、is_timeout(全小写,不可导出) - ⚠️ 布尔返回函数可用
Is、Has、Can开头,但仍是大写:IsClosed、HasRole
私有函数统一小写驼峰,不加下划线
只在当前包内使用的函数,必须小写开头,如 parseURL、buildQuery、checkAuth。注意 URL 是特有名词,按规范应保持原写法,所以是 parseURL 而不是 parseUrl 或 parse_url。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- ✅ 正确:
parseURL、apiClient(私有变量/函数首词小写)、userID - ❌ 错误:
ParseUrl(首字母大写变公有)、parse_url(含下划线)、parseurl(丢失大小写语义) - ? 特有名词处理:若为私有且是首个词,用小写;否则保持原形,如
APIClient、HTTPServer
接口方法命名也遵循同一套规则
接口里定义的方法,和普通函数一样受可见性控制。单方法接口习惯以 -er 结尾(如 Reader),但方法本身仍要大写:Read、Write、Close。你不能在接口里写 read,否则实现时无法满足导出要求。
- ✅ 正确:
type Reader interface { Read([]byte) (int, error) } - ❌ 错误:
type reader interface { read([]byte) (int, error) }(整个接口无法导出) - ⚠️ 接口名本身也是类型,若需导出,同样首字母大写:
Stringer,不是stringer
最容易被忽略的是:函数名不是“怎么好看怎么来”,而是直接绑定语言的导出机制。写错大小写,编译不报错,但其他包 import 后调不到——这种问题往往卡在测试或集成阶段,排查成本远高于写的时候多看一眼首字母。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










