Golang——详解Go语言代码规范

仲卿發表於 2020-4-20 20:26:00

本文始发于个人公众号：TechFlow，原创不易，求个关注
 
<section id="nice" data-tool="mdnice编辑器" data-website="https://www.mdnice.com" style="font-size: 16px; color: rgba(0, 0, 0, 1); padding: 0 10px; line-height: 1.6; word-spacing: 0; letter-spacing: 0; word-wrap: break-word; text-align: left; font-family: Optima-Regular, Optima, PingFangSC-light, PingFangTC-light, "PingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif; margin-top: -10px">今天是Golang专题的第二篇，我们来看看Go的语言规范。
在我们继续今天的内容之前，先来回答一个问题。
有同学在后台问我，为什么说Golang更适合分布式系统的开发？它和Java相比有什么优势吗？
其实回答这个问题需要涉及很多概念，比如操作系统当中关于进程、线程、协程等很多概念。我们将这些内容进行简化，举一个最简单的线程的例子。我们来写一段在java当中实现多线程的例子：
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">public class MyThread implemnts Runnable {     public void run() {       System.out.println("I am a thread")     } } public class Test {     public static void main(String args[]) {         MyThread thread1 = new MyThread();         thread1.start();     } } </code></pre>
我们再来看看Golang：
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">func run() {     fmt.Println("I am a Thread") } func main() {     go run() } </code></pre>
这么一对比是不是简单很多？
<h2 data-tool="mdnice编辑器" style="margin-top: 30px; font-weight: bold; font-size: 22px; border-bottom: 2px solid rgba(89, 89, 89, 1); margin-bottom: 30px; color: rgba(89, 89, 89, 1)">Golang的语言规范</h2>
大家都知道程序员最大的分歧之一就是花括号到底应该写在哪一行，有另写一行的，也有跟在循环体后面的。这两拨人分成了两个流派，彼此征战不休，也衍生出了许多段子。
为了统一风格，很多语言对代码风格做了规范。比如Python就去掉了花括号，而使用空格来进行代码缩进。然而不幸的是，有些人缩进用四个空格，也有些人用tab，这双方又形成了阵营，彼此争吵不停……
也许Golang的开发者曾经饱受代码风格争吵的苦恼，所以Golang做了一个划时代的事情，它严格限制了代码风格，强行统一大家都必须使用同一套风格，否则就分分钟报错给你看。所以在我们进行具体的语法学习之前，先从语言规范开始，否则等我们后面养成了不好的习惯再想要改正就会成本很高。其实改正代码风格是一件很难的事情，老实说我的代码风格不是很好，总是使用一些cur、pnt、node、u、v这种简单的变量，这也是当年打acm留下来的习惯，想改一时半会蛮难的。所以大家一定要在初期就养成好习惯，坏习惯就留给我一个人吧（大雾）。
<h3 data-tool="mdnice编辑器" style="margin-top: 30px; margin-bottom: 15px; font-weight: bold; font-size: 20px; color: rgba(89, 89, 89, 1)">package规范</h3>
Golang的语言规范很多，涉及的面很广，有些我们暂时用不到，我们先挑基础的说。首先是package规范，对于package来说它的名字应该和目录保持一致，采取有意义的包名，不要起一些别人看不懂的名字。比如test、unit这种，并且不能和标准库冲突。
其次是我们在引包的时候，需要注意不要使用相对路径，而应该使用绝对路径。
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">// wrong import "../../../repo" // correct import "github.com/repo/package </code></pre>
当然我们可以装一个goimport工具，帮助我们自动引包。但是自动引包也会有坑，尤其是当目录下存在两个包名称一样的时候，有可能会引入错误，需要我们自己留意。
<h2 data-tool="mdnice编辑器" style="margin-top: 30px; font-weight: bold; font-size: 22px; border-bottom: 2px solid rgba(89, 89, 89, 1); margin-bottom: 30px; color: rgba(89, 89, 89, 1)">代码风格规范</h2>
Go语言当中规定了我们应该使用驼峰标准来命名变量，不能使用_。在Go当中首字母大写表示结构体中的变量或者是包中的函数public，如果是小写则表示是private，这一点尤其需要注意。刚开始写go的时候都会很不习惯，因此踩坑是常有的事。
golang当中是有常量的，golang当中的常量一样用驼峰标准，首字母大写。比如我们起一个常量叫做app_env，表示当前app运行的环境，我们必须要这样定义：
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">const AppEnv = "env" </code></pre>
另一点是Golang的设计者认为行尾加上分号毫无必要，所以在编译器当中添加了会在行尾自动加上分号的功能。所以我们可以加也可以不加，但是一般认为没有必要这么做。所以普遍来说，除了在循环体或者是判断条件当中，我们一般是不写分号的。当然也有特殊情况，比如你想要把多条语句写在一行的时候：
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">var a int; var b float; a = 3; b = 3.2; </code></pre>
当然还是一般不推荐这么干，建议分成多行，更加美观。
另外一点是golang当中所有的变量和包都必须用上，不允许定义没有使用的东西，否则也会报错。也就是说严格限制了我们写代码时候的谨慎。不能随意申请用不到的变量，大多数语言当中没有这样的限制，但是golang当中做了限制，所以我们写代码的时候要小心。
另外一点是关于花括号，在golang当中严格限制了花括号写在当前行，而不是另起一行。
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">// wrong if expression  {   ... } // correct if expression {   ... } </code></pre>
从上面这个例子我们还可以注意到一点，就是在golang当中if后面的条件不加括号，这点和Python一样。但是如果你写惯了java或者是C++刚开始可能会不太适应。
最后一点是golang的代码规范检测工具golint当中规定了所有的函数以及结构体头部必须要写注释，并且对注释的规范也进行了限制。注释的规范是名称加上说明，如果不写或者是不规范的话，代码虽然可以运行，但是无法通过golint的规范检测。一般来说公司的开发环境都会做限制，只有通过golint规范检测的代码才可以提交发布。
<pre class="custom" data-tool="mdnice编辑器" style="margin-top: 10px; margin-bottom: 10px"><code class="hljs" style="overflow-x: auto; padding: 16px; color: rgba(51, 51, 51, 1); background: rgba(248, 248, 248, 1); font-family: Operator Mono, Consolas, Monaco, Menlo, monospace; border-radius: 0; font-size: 12px; -webkit-overflow-scrolling: touch">// HelloWorld print hello world func HelloWorld() {     fmt.Println("Hello World") } </code></pre>
另外一点是golang不支持隐式类型转换，比如int和int32以及int64，会被视作是不同的类型。如果我们将一个int32的变量赋值给int类型，则会引起报错，必须要我们手动转换。这当然增加了编码时候的工作，但是也避免了很多由精度不一样产生的问题。
除了这些之外，golang当中还定义了对结构体定义以及错误处理等内容的规范。但是对于我们初学者而言，目前这些是必须要了解的，其他的内容可以等我们后续遇见了再熟悉。
一门语言对于代码风格做了严格的规范限制对于初学者而言可能是一件比较蛋疼的事情，因为要记的东西变多了，我们不仅要学会语法，还要搞清楚这些规范。但是当我们熟悉了或者是工作了之后，会发现这其实是一件好事。对于多人协作的场景而言，大家都遵守一样的规范会大大提升代码交流以及协作的效率。如果你们看过其他代码风格和自己完全不同的人的代码之后，相信你们对于这点一定会有更深的认识。
<h2 data-tool="mdnice编辑器" style="margin-top: 30px; font-weight: bold; font-size: 22px; border-bottom: 2px solid rgba(89, 89, 89, 1); margin-bottom: 30px; color: rgba(89, 89, 89, 1)">总结</h2>
从规范的严格程度以及对面向对象的阉割程度看起来，golang简直不像是一门新生的语言，倒有些上世纪老派语言的风格。但是偏偏golang又有很多新鲜特性，比如允许函数值返回多个结果，支持匿名函数以及部分函数式编程的功能等等。在初学的阶段，我也非常抗拒它，可能是因为Python写得太多了，习惯了动态语言。但是随着对这门语言了解的深入，我越来越多地发现了它这些设计理念背后的思考和智慧，慢慢对它改观，时至今日，我已经不再怀疑这是一门优秀的语言，这几年的流行并不是没有道理的。
另外很重要的一点是，因为golang太特立独行了，所以经常会让我思考它这么做背后的用意是什么？这么一思考，加上查阅一些资料，能够发现很多之前思维当中的盲点。在之前学习语言的时候，我是绝对不会去思考语言的设计者为什么要这么设计的，只会依葫芦画瓢，照着把相关的内容学会仅此而已。这样的思考除了能够提升对于语言本身的理解之外，也能够提升对问题场景的思考和理解，对于工程师而言，后者其实是更为重要的。
当然这些内容我光说是没有用的，也需要屏幕前的你用心去体会。
希望大家都能感受到golang的魅力，都能在此过程当中收货成长，加油！如果觉得有所收获，请顺手点个在看或者转发吧，你们的举手之劳对我来说很重要。
</section>
<img src="https://user-gold-cdn.xitu.io/2020/4/20/171978c0b27afec0?w=258&h=258&f=png&s=23988"> 
来源：https://www.cnblogs.com/techflow/p/12740198.html

頁: [1]

琼殿技术论坛's Archiver

Golang——详解Go语言代码规范