Satu kuali standard pengekodan dalam bahasa Go

Lepaskan: 2023-07-24 17:45:24
ke hadapan
1188 orang telah melayarinya

Setiap bahasa mempunyai piawaian pengekodan tersendiri yang tersendiri Mempelajari piawaian penamaan bahasa itu boleh menjadikan kod yang anda tulis lebih mudah dibaca dan kurang terdedah kepada ralat peringkat rendah.

Berdasarkan tabiat pengekodan peribadi dan beberapa artikel di Internet, artikel ini telah menyusun beberapa piawaian pengekodan yang boleh digunakan oleh semua orang, tetapi mereka tidak mewakili yang rasmi.

1. Penamaan fail

  1. Memandangkan nama fail platform Windows tidak sensitif huruf besar-besaran, nama fail hendaklah sentiasa menggunakan huruf kecil

  2. Gunakan garis bawah di antara perkataan yang berbeza
  3. _test.go 结尾

  4. 文件若具有平台特性,应以 文件名_平台.goJika ia adalah fail ujian, anda boleh menggunakan _test.go berakhir dengan

    🎜🎜🎜. Jika fail mempunyai ciri platform, ia hendaklah berakhir dengan Nama fail_platform.go penamaan, seperti utils_ windows.go, utils_linux.go, platform yang tersedia ialah: windows, unix, posix, plan9 , darwin, bsd, linux, freebsd, nacl, netbsd, openbsd, solaris, dragonfly, bsd, notbsd, android, stubs🎜
  5. Secara amnya, pintu masuk utama aplikasi hendaklah main.go, atau dinamakan dalam semua huruf kecil aplikasi. Sebagai contoh, pintu masuk MyBlog boleh menjadi myblog.gomyblog.go

2. 常量命名

目前在网络上可以看到主要有两种风格的写法

  1. 第一种是驼峰命名法,比如 appVersion

  2. 第二种使用全大写且用下划线分词,比如 APP_VERSION

这两种风格,没有孰好孰弱,可自由选取,我个人更倾向于使用第二种,主要是能一眼与变量区分开来。

如果要定义多个变量,请使用 括号 来组织。

const (
  APP_VERSION = "0.1.0"
  CONF_PATH = "/etc/xx.conf"
)
Salin selepas log masuk

3. 变量命名

和常量不同,变量的命名,开发者们的喜好就比较一致了,统一使用 驼峰命名法

2. Penamaan berterusan

    Pada masa ini terdapat dua gaya utama yang boleh dilihat di Internet Cara menulis
  1. Yang pertama ialah unta kaedah penamaan kes, seperti appVersion< /span>🎜🎜🎜

    Yang kedua jenis menggunakan semua pembahagian perkataan huruf besar dan bergaris bawah , seperti APP_VERSION🎜🎜

🎜Tiada yang lebih baik atau lebih lemah daripada kedua-dua gaya ini, anda boleh memilih secara bebas Saya secara peribadi lebih suka yang kedua, terutamanya kerana ia boleh dibezakan daripada pembolehubah sepintas lalu. 🎜🎜Jika anda ingin mentakrifkan berbilang pembolehubah, sila gunakan kurungan untuk menyusunnya. 🎜
// A GonicMapper that contains a list of common initialisms taken from golang/lint
var LintGonicMapper = GonicMapper{
    "API":   true,
    "ASCII": true,
    "CPU":   true,
    "CSS":   true,
    "DNS":   true,
    "EOF":   true,
    "GUID":  true,
    "HTML":  true,
    "HTTP":  true,
    "HTTPS": true,
    "ID":    true,
    "IP":    true,
    "JSON":  true,
    "LHS":   true,
    "QPS":   true,
    "RAM":   true,
    "RHS":   true,
    "RPC":   true,
    "SLA":   true,
    "SMTP":  true,
    "SSH":   true,
    "TLS":   true,
    "TTL":   true,
    "UI":    true,
    "UID":   true,
    "UUID":  true,
    "URI":   true,
    "URL":   true,
    "UTF8":  true,
    "VM":    true,
    "XML":   true,
    "XSRF":  true,
    "XSS":   true,
}
Salin selepas log masuk
Salin selepas log masuk

3. Pembolehubah Penamaan

🎜Berbeza daripada pemalar, penamaan pembolehubah adalah lebih konsisten dalam kalangan pembangun Gunakannya secara seragamCamelCase🎜🎜 🎜🎜Dalam agak persekitaran mudah (dengan bilangan objek yang kecil dan penyasaran yang kuat), perkataan lengkap boleh dipendekkan kepada satu huruf, sebagai contoh: pengguna ditulis sebagai u🎜
  • 若该变量为 bool 类型,则名称应以 Has, Is, CanAllow 开头。例如:isExist ,hasConflict 。

  • 其他一般情况下首单词全小写,其后各单词首字母大写。例如:numShips 和 startDate 。

  • 若变量中有特有名词(以下列出),且变量为私有,则首单词还是使用全小写,如 apiClient

  • 若变量中有特有名词(以下列出),但变量不是私有,那首单词就要变成全大写。例如:APIClientURLString

  • 这里列举了一些常见的特有名词:

    // A GonicMapper that contains a list of common initialisms taken from golang/lint
    var LintGonicMapper = GonicMapper{
        "API":   true,
        "ASCII": true,
        "CPU":   true,
        "CSS":   true,
        "DNS":   true,
        "EOF":   true,
        "GUID":  true,
        "HTML":  true,
        "HTTP":  true,
        "HTTPS": true,
        "ID":    true,
        "IP":    true,
        "JSON":  true,
        "LHS":   true,
        "QPS":   true,
        "RAM":   true,
        "RHS":   true,
        "RPC":   true,
        "SLA":   true,
        "SMTP":  true,
        "SSH":   true,
        "TLS":   true,
        "TTL":   true,
        "UI":    true,
        "UID":   true,
        "UUID":  true,
        "URI":   true,
        "URL":   true,
        "UTF8":  true,
        "VM":    true,
        "XML":   true,
        "XSRF":  true,
        "XSS":   true,
    }
    Salin selepas log masuk
    Salin selepas log masuk

    4. 函数命名

    1. 函数名还是使用 驼峰命名法

    2. 但是有一点需要注意,在 Golang 中是用大小写来控制函数的可见性,因此当你需要在包外访问,请使用 大写字母开头

    3. 当你不需要在包外访问,请使用小写字母开头

    另外,函数内部的参数的排列顺序也有几点原则

    1. 参数的重要程度越高,应排在越前面

    2. 简单的类型应优先复杂类型

    3. 尽可能将同种类型的参数放在相邻位置,则只需写一次类型

    5. 接口命名

    使用驼峰命名法,可以用 type alias 来定义大写开头的 type 给包外访问。

    type helloWorld interface {
        func Hello();
    }
    
    type SayHello helloWorld
    Salin selepas log masuk

    当你的接口只有一个函数时,接口名通常会以 er 为后缀

    type Reader interface {
        Read(p []byte) (n int, err error)
    }
    Salin selepas log masuk

    5. 注释规范

    注释分为

    5.1 包注释

    1. 位于 package 之前,如果一个包有多个文件,只需要在一个文件中编写即可

    2. 如果你想在每个文件中的头部加上注释,需要在版权注释和 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
    Salin selepas log masuk
    1. 如果是特别复杂的包,可单独创建 doc.go 文件说明

    5.2 代码注释

    用于解释代码逻辑,可以有两种写法

    单行注释使用 // ,多行注释使用 /* comment */

    // 单行注释
    
    /*
    多
    行
    注
    释
    */
    Salin selepas log masuk

    另外,对于代码注释还有一些更加苛刻的要求,这个看个人了,摘自网络:

    • 所有导出对象都需要注释说明其用途;非导出对象根据情况进行注释。

    • 如果对象可数且无明确指定数量的情况下,一律使用单数形式和一般进行时描述;否则使用复数形式。

    • 包、函数、方法和类型的注释说明都是一个完整的句子。

    • 句子类型的注释首字母均需大写;短语类型的注释首字母需小写。

    • 注释的单行长度不能超过 80 个字符。

    • 类型的定义一般都以单数形式描述:

      // Request represents a request to run a command.  type Request struct { ...
      Salin selepas log masuk
    • 如果为接口,则一般以以下形式描述:

      // FileInfo is the interface that describes a file and is returned by Stat and Lstat.
      type FileInfo interface { ...
      Salin selepas log masuk
    • 函数与方法的注释需以函数或方法的名称作为开头:

      // Post returns *BeegoHttpRequest with POST method.
      Salin selepas log masuk
    • 如果一句话不足以说明全部问题,则可换行继续进行更加细致的描述:

      // Copy copies file from source to target path.
      // It returns false and error when error occurs in underlying function calls.
      Salin selepas log masuk
    • 若函数或方法为判断类型(返回值主要为 bool 类型),则以 <name> returns true if 开头:

      // HasPrefix returns true if name has any string in given slice as prefix.
      func HasPrefix(name string, prefixes []string) bool { ...
      Salin selepas log masuk

    5.3 特别注释

    • TODO:提醒维护人员此部分代码待完成

    • FIXME:提醒维护人员此处有BUG待修复

    • NOTE:维护人员要关注的一些问题说明

    6. 包的导入

    单行的包导入

    import "fmt"
    Salin selepas log masuk

    多个包导入,请使用 () 来组织

    import (
      "fmt"
      "os"
    )
    Salin selepas log masuk

    另外根据包的来源,对排版还有一定的要求

    1. 标准库排最前面,第三方包次之、项目内的其它包和当前包的子包排最后,每种分类以一空行分隔。

    2. 尽量不要使用相对路径来导入包。

    import (
        "fmt"
        "html/template"
        "net/http"
        "os"
    
        "github.com/codegangsta/cli"
        "gopkg.in/macaron.v1"
    
        "github.com/gogits/git"
        "github.com/gogits/gfm"
    
        "github.com/gogits/gogs/routers"
        "github.com/gogits/gogs/routers/repo"
        "github.com/gogits/gogs/routers/user"
    )
    Salin selepas log masuk

    7. 善用 gofmt

    除了命名规范外,Go 还有很多格式上的规范,比如

    1. 使用 tab 进行缩进

    2. 一行最长不要超过 80 个字符

    因此在格式上的问题,你大部分都可以放心交由 gofmt 帮你调整。关于 gofmt 的文章还在写,应该这两天就会更新。你可以过两天再来看看。

    Atas ialah kandungan terperinci Satu kuali standard pengekodan dalam bahasa Go. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

    Label berkaitan:
    sumber:Go语言进阶学习
    Kenyataan Laman Web ini
    Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn
    Tutorial Popular
    Lagi>
    Muat turun terkini
    Lagi>
    kesan web
    Kod sumber laman web
    Bahan laman web
    Templat hujung hadapan