好得很程序员自学网

<tfoot draggable='sEl'></tfoot>

GoLang代码规范

GoLang代码规范

GoLang-代码规范

开始一项新语言前需要先了解该语言的语法 ( 如果你有其他语言的编程知识的话 ) ,开始学习前,我们一起了了解下 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 中名称不但具有表达含义的功能,同时也具有约束使用的特点。如果一个函数的名称是小写的则表示该函数不能在其他包中无法使用。

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

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

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

分号

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

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

// 错误的方式

if(1==2)

{

fmt.Println("God!")

}

// 正确的书写

if(1==2) {

fmt.Println("God!")

}


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

转载时请注明出处!老虞http://HdhCmsTestcnblogs测试数据/howDo/

 

分类:  GoLang

标签:  GoLang

作者: Leo_wl

    

出处: http://HdhCmsTestcnblogs测试数据/Leo_wl/

    

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

版权信息

查看更多关于GoLang代码规范的详细内容...

  阅读:47次