老虞要学GoLang-代码规范

Gopher老虞 · · 1445 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

      开始一项新语言前需要先了解该语言的语法(如果你有其他语言的编程知识的话),开始学习前,我们一起了解下Go的格式。

      如果大家都统一编码风格,那么在维护他人代码时就能带来便利。同时我们在提交代码前执行一次fmt命令,以便提交统一风格的代码。

      

注释

Go支持C语言风格的“//”块注释,也支持C++风格的行注释,同时可使用/**/进行包的 注释. 我们看string包的源代码,使用//注释了包,方法以及行。我们需要养成好的习惯,尽量去多写些注释,这样不但有利于自己以后的回顾,已给他人阅读你的代码提供了方便,当然Go下的源代码使用Go命令能够生成文档,而文档的描述内容源自注释,在编码阶段就同步书写注释,而不要在整理代码时书写注释(此时的思维没有编码时清晰,补救中总容易丢失些东西)

1// Copyright 2009 The Go Authors. All rights reserved.
2// Use of this source code is Governed by a BSD-style
3// license that can be found in the LICENSE file.
4
5// Package strings implements simple functions to manipulate strings.
6 package strings
7
8 import (
9 "unicode"
10 "utf8"
11 )
12
13// explode splits s into an array of UTF-8 sequences, one per Unicode character (still strings) up to a maximum of n (n < 0 means no limit).
14// Invalid UTF-8 sequences become correct encodings of U+FFF8.
15 func explode(s string, n int) []string {
16 if n == 0 {
17 return nil
18 }
19 l := utf8.RuneCountInString(s)
20 if n <= 0 || n > l {
21 n = l
22 }
23 a := make([]string, n)
24 var size, rune int
25 i, cur := 0, 0
26 for ; i+1 < n; i++ {
27 rune, size = utf8.DecodeRuneInString(s[cur:])
28 a[i] = string(rune)
29 cur += size
30 }
31// add the rest, if there is any
32 if cur < len(s) {
33 a[i] = s[cur:]
34 }
35 return a
36 }




命名

Go中名称不但具有表达含义的功能,同时也具有约束使用的特点。如果一个函数的名称是小写的则表示该函数不能在其他包中使用。

    1. 命名必须使用骆驼命名法,而不能使用下划线法。

    2. 任何需要对外暴露的名字必须大写字母开头,不需要暴露在包外的名字必须以小写字母开头。

    3. 接口的命令,按照惯例,如果接口只有一个方法,则该接口命名为方法名成加上”ER“后缀。

分号

GoC语言一样使用“;”来结束一个语句,但不一样的是,在Go中由编译器去处理“;”,所以你必须在编写代码是省略“;”。当然也有例外,for循环(使用;将初始部分、条件部分和遍历元素区分),一行中有多个语句,多赋值语句等。

需要注意,不能将控制语句(for,if else,switch,select)的左括号另起一行。如

//错误的方式

if(1==2)

{

fmt.Println("God!")

}


//正确的书写

if(1==2) {

fmt.Println("God!")

}


学到新的知识后,再补充。

 ---------2013-04-10 补充---------------------

  Go语言编程规范:

      官方地址:http://golang.org/doc/effective_go.html    (墙了)

      中文翻译:http://zh-golang.appsp0t.com/ref/spec?lang=en

------------------end------------------------------


有疑问加站长微信联系(非本文作者)

本文来自:开源中国博客

感谢作者:Gopher老虞

查看原文:老虞要学GoLang-代码规范

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

1445 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传