编写地道的Go代码
最地道的Go代码就是Go的标准库的代码,有空的时候可以多看看Google的工程师是如何实现的。
1. 注释
可以通过/* ... */
或者//
增加注释, //
之后应该有个空格
如果想在每个文件的头部加上注释,需要在版权注释和Package前面加一个空行,否则版权注释会作为package的注释
// Copyright 2009 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
/*
Package net provides a portable interface for network I/O, including
TCP/IP, UDP, domain name resolution, and Unix domain sockets.
......
*/
package net
......
注:注释应该用一个完整的句子,注释的第一个单词应该是要注释的指示符,以便在godoc中容易查找; 注释应该以 .
结尾;
2. 声明slice
使用下面这种方式声明slice:
var s []string
而不是下面这种格式
t := []string{}
注:前者声明了一个nil
slice, 而后者声明了一个长度为0的非nil
slice
3. 字符串的大小写
错误字符串不应该大写,应写成:
fmt.Errorf("failed to write data.")
而不是写成:
fmt.Errorf("Failed to write data")
因为,这些字符串可能和其他字符串相连接,组合后的字符串如果中间有大写字母开头的单词很突兀,除非这些首字母大写单词是固定使用的单词。
注:缩写词必须保持一致,比如都大写URL或者小写url;常亮一般声明为MaxLength,而不是以下划线分割MAX_LENGTH或者MAXLENGTH;
4. 处理error而不是panic或者忽略
为了代码的强健性,不要使用_忽略错误,而是要处理每一个错误,尽管代码写起来有些繁琐也不要忽略错误;
尽量不要使用panic;
5. 一些名称
包名应该使用单数形式,比如util,model,而不是utils,models;
Receiver的名称应该缩写,一般使用一个或两个字符作为Receiver的名称,如:
func (f foo) method {
...
}
有些单词可能有多种写法,在项目中应保持一致,比如Golang采用的写法:
// marshaling
// unmarshaling
// canceling
// cancelation
而不是:
// marshalling
// unmarshalling
// cancelling
// cancellation
6. 空字符串检查
正确方式:
if s == "" {
...
}
而不是:
if len(s) == 0 {
...
}
更不是:
if s == nil || s == ""{
...
}
7. 非空slice检查
正确方式:
if len(s) > 0 {
...
}
而不是:
if s != nil && len(s) > 0 {
...
}
8. 直接使用bool值
对于bool类型的变量var b bool, 直接使用它作为判断,而不是使用它和true/false进行比较
正确方式:
if b {
...
}
if !b {
...
}
而不是:
if b == true {
...
}
if b == false {
...
}
9. byte/slice/string相等性比较
var s1 []byte
var s2 []byte
...
bytes.Equal(s1, s2) == 0
bytes.Equal(s1, s2) != 0
而不是:
var s1 []byte
var s2 []byte
...
bytes.Compare(s1, s2) == 0
bytes.Compare(s1, s2) != 0
10. 检查是否包含子字符串
应使用strings.ContainesRune
, strings.ContainesAny
, strings.Contains
11. 复制slice
使用内建函数copy,而不是遍历slice逐个复制
正确方式
var b1, b2 []byte
copy(b2, b1)
12. 尽量缩短if
正确方式:
var a, b int
...
return a > b
而不是:
var a, b int
...
if a > b {
return true
} else {
return false
}
13. 简化range
正确方式:
for range m {
...
}
而不是:
var m map[string]int
for _ = range m {
}
for _, _ = range m {
}
14. 使用strings.TrimPrefix / strings.TrimSuffix
正确方式:
var s1 = "a string value"
var s2 = "a "
var s3 = strings.TrimPrefix(s1, s2)
而不是:
var s1 = "a string value"
var s2 = "a "
var s3 string
if strings.HasPrefix(s1, s2) {
s3 = s1[len(s2):]
}
15 .append slice
正确方式:
var a, b []byte
a = append(b, a...)
而不是:
var a, b []byte
for _,v range a {
append(b, v)
}
参考文档
http://colobu.com/2017/02/07/write-idiomatic-golang-codes/ effective go
https://go-zh.org/doc/effective_go.html
- 微软在动态语言支持上超越了Java?
- JAVA图片批量上传JS-带预览功能
- Netty-Websocket 根据URL路由,分发机制的实现
- DrawerLayout实现网易新闻抽屉效果
- shiro权限控制(一):shiro介绍以及整合SSM框架
- websocket(三) 进阶!netty框架实现websocket达到高并发
- Kafka源码系列之Broker的IO服务及业务处理
- Dubbo(五) Dubbo入门demo——helloworld
- Dubbo(四) Dubbo-Admin项目 Dubbo管理台
- volley请求原理
- Dubbo(三) 安装Zookeeper 单机-集群
- ASP.NET MVC Preview生命周期分析
- Dubbo(二) 认识Zookeeper
- Kafka源码系列之使用要点总结及重要错误解决
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- CentOS7.4下编译Hadoop-2.7.6
- VMware安装CentOS6
- VMware安装CentOS7 3.1 主机名修改3.2 网卡名修改3.3 ifconfig安装
- VMware网络设置
- Destoon 6.0 guestbook.php 通用SQL注入漏洞
- Hadoop2.7.6_01_部署
- Hadoop2.7.6_02_HDFS常用操作
- Bottle HTTP 头注入漏洞探究
- Hadoop2.7.6_03_HDFS原理
- Hadoop2.7.6_04_HDFS的Shell操作与常见问题
- Hadoop2.7.6_05_mapreduce-Yarn
- Hadoop2.7.6_06_mapreduce参数优化
- NFS服务搭建与配置
- Hadoop2.7.6_07_HA高可用
- Hadoop2.7.6_08_Federation联邦机制 1.1. HDFS-federation图解2.1. 注意事项3.1. 部署3.2. 环境变量3.3. c