Uber Go 语言编程规范:避免使用内置的名称

Go-Language-Specification:Golang官网语言规范指南译本 Go 语言参考手册 官网 译文 版本:May 9, 2018 译者序 目录                                             整型字面值     浮点字面值     虚数字面值     Rune 字面值     字符串字面量 常量 变量 类型     方法集     布尔类型     数字类型     字符串类型     数组类型     切片类型     结构体类型     指针类型     函数类型     接口类型     Map类型     Channel类型 类型的属性和值     类型标识     可分配性     代表性 代码块 声明和作用域     标签的作用域     空标识符     预定义的标识符     导出标识符     标识符的唯一性     常量声明     Iota     类型声明     变量声明     短变量声 立即下载

Go语言的language specification 中概括了几个内置的、predeclared identifiers (预声明的标识符),这些标识符不应该在Go程序中再次用作名称。

依赖于上下文,重新将这些标识符用做名称,将会遮盖原始标识符在当前的词法作用域(以及任何嵌套作用域)或者混淆代码,影响正常的代码逻辑。

最好的情况是,编译器将会报错。最坏的情况是,这样的代码可能会引起潜在的、难以捕捉的bug。

Bad

var error string
// `error` 覆盖了内建的error词法作用域

// or

func handleErrorMessage(error string) {
    // `error` 返回值名称 error,覆盖了内建的error词法作用域
}
type Foo struct {
    // 虽然这些字段技术上讲可行, 但是
    // `error` or `string` 字符串语义上模棱两可
    error  error
    string string
}

func (f Foo) Error() error {
    // `error` and `f.error` 表面上是相似的
    return f.error
}

func (f Foo) String() string {
    // `string` and `f.string` 表面上相似的
    return f.string
}

Good

var errorMessage string
// `error` refers to the builtin

// or

func handleErrorMessage(msg string) {
    // `error` refers to the builtin
}
type Foo struct {
    // `error` and `string` 现在就很明确了
    err error
    str string
}

func (f Foo) Error() error {
    return f.err
}

func (f Foo) String() string {
    return f.str
}

请注意,当使用预先声明的标识符时,编译器是不会生成错误的,但是go vet等工具应该能够正确地指出这些和其他隐藏的情况。

the Go Programming Language Specification the Go Programming Language Specification C语言圣经 本书由《C程序设计语言》的作者Kernighan和谷歌公司Go团队主管Alan Donovan联袂撰写,是学习Go语言程序设计的指南。本书共13章,主要内容包括:Go的基础知识、基本结构、基本数据类型、复合数据类型、函数、方法、接口、goroutine、通道、共享变量的并发性、包、go工具、测试、反射等。 立即下载

相关推荐

LIGGGHTS开源离散元仿真:从基础安装到高级应用实战

本文详细介绍了LIGGGHTS开源离散元仿真软件的基础安装、脚本编写及高级应用实战。从颗粒自由落体模拟到工业级复杂系统建模,涵盖CFD-DEM耦合、高性能计算优化等关键技术,帮助用户快速掌握这一强大的颗粒仿真工具。特别适合需要处理颗粒系统仿真的科研人员和工程师。

l1k9j8h7g6的博客 621

10 The Go Programming Language Specification go语言规范 重点

The Go Programming Language Specificationgo语言规范 Version of May 9, 2018 Introduction介绍Notation符号Source code representation源代码表示形式Characters字符Letters and digits字母和数字Lexical elements词法元素...

weixin_30708329的博客 991

BQ40Z50R2循环学习实战:量产文件生成与关键状态位解析

本文详细解析了TI BQ40Z50R2电量计循环学习(Golden Learning)的实战流程与量产文件生成方法。重点剖析了updateStatus状态位在充放电静置阶段的常见异常(如卡在0x04或跳至0x0E)及其根本原因,并提供了从环境控制、命令顺序到文件处理的完整避坑指南,帮助工程师高效完成量产配置。

weixin_29170327的博客 215

Go 编程语言规范

Go 编程语言规范 2013年05月08日版本 简介 记号 源代码表示 字符 字母和数字 词法元素 注释 符号 分号 标识符 关键字 操作符/运算符和分隔符 整型值 浮点值 虚数值 分符值 字符串值 常量 类型 方法集 布尔类型 数值类型 字符串类型 数组类型 分片类型 结构体类型 指针类型 函数类型 接口类型 映射类型 管道类型 类型和值的性质 类型一致 转换 块 声明和作用域 标...

stephen830 4307

Delft3D从入门到实践:安装、编译与首次模拟指南

本文为Delft3D初学者提供了一份详尽的从零开始指南。内容涵盖软件获取、许可证申请、图形界面安装、核心计算内核的编译环境搭建与编译步骤,以及最终整合运行首个水动力模拟的全流程。重点解决了Windows系统下Delft3D安装与编译的常见问题,帮助用户快速上手这一开源水动力与泥沙输运模拟工具。

weixin_29303701的博客 542

Docker安装Nacos(详细教程)

Docker安装Nacos的步骤相对直接,但需要注意一些细节以确保安装成功。

weixin_73060959的博客 1407

CheckStyle报错的常见问题及解决方式

CheckStyle报错的常见问题及解决方式

5万+

利用插件扩展 Qt 应用程序

不仅 Qt 本身可以通过插件进行扩展,而且 Qt 应用程序也可以通过插件来扩展,这需要应用程序使用 `QPluginLoader` 检测和加载插件。

青春不老,奋斗不止! 1万+

Uber Go 语言编码规范

Uber Go 语言编码规范 中文版

J_Lee 2214

遥感影像道路提取算法——SGCN

用于从高分辨率遥感图像(TGRS)中提取复杂环境中道路的分割深度可分离图卷积网络摘要:高分辨率遥感图像的道路信息在各个领域得到广泛应用,基于深度学习的方法有效地显示了较高的道路提取性能。然而,在高分辨率遥感图像中,检测柏油路封闭或树木覆盖的道路,仍存在一些挑战,限制了提取的准确性:1)道路之间的阶级内差异较大,城市物体,特别是道路和建筑物之间的阶级间差异不明显;2)被树木、阴影和建筑物遮挡的道路难以提取;3)道路缺乏高精度遥感数据集。

littleyy666的博客 3848

重复点击提交、产生多笔数据、保持数据只操作一次---->接口幂等性校验

幂等校验一、工作真实场景 + 常出现场景二、工作解决方案 + 百度解决方案 一、工作真实场景 + 常出现场景 真实场景:在一次工作中进行成品出库创建成品出库单时,手抖了一下,重复点击了两次确定(提交表单)。结果很神奇的发现居然产生了两笔一模一样的数据(流水号都一样),当时就很懵逼,稍作思考,想想应该是在同一时刻创建了两个出库单。感觉很有意思(因为之前没有遇到过,写代码的时候也没有考虑到这个问题的发生),后面换了一种方式复现场景:提交表单时多次点击Enter按钮,还是会产生多笔重复数据。 常见场景: 订单接

私聊前往站内信:https://i.youkuaiyun.com/#/msg/chat/weixin_44976692 6万+

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞

值得参考的golang语言开发规范:Uber Go 语言编码规范,一些优秀的技巧可以提升代码的质量、避免代码缺陷和bug漏洞。

代码讲故事 1113

cesium加载geotiff的 四种方法

本文介绍了在Cesium中加载GeoTIFF数据的两种主要方法。首先解析了核心前置知识,包括坐标系匹配、数据类型区分和性能优化。方法1详细演示了如何将RGB影像GeoTIFF转换为Cesium影像图层,包含从数据解析到Canvas转换的完整代码流程。方法2则针对高程数据(DEM)处理,展示了前端直接解析构建地形网格的方案。文章提供了完整的代码示例和关键实现要点,适用于卫星影像、专题图和数字高程模型等多种GeoTIFF数据类型在三维场景中的可视化需求。

大剑师兰特的GIS世界 397

Uber Go 风格指南:避免使用内置名称(预声明标识符)的命名规范与实战

本篇指南讲解 Uber Go Style Guide(本仓库 [src/builtin-name.md](https://link.gitcode.com/i/1fb1ff754b2f33c44587d5b2d4fa3be7))中"避免使用内置名称"这一核心规范:Go 语言规范定义了一组预声明标识符(built-in / predeclared identifiers),把它们当作变量、参数、结构

gitblog_00992的博客 359

IDEA的使用指南

IDEA基于java的使用手册,可以最快速的上手,在使用中不断的丰富自己的使用技巧.

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译

uber_go_guide_tw:Uber Go 语言编写规范繁体中文翻译 项目介绍 Uber Go 语言编写规范是由Uber公司开源的一套用于指导Go语言编写的最佳实践。这些规范旨在帮助开发者编写易于管理、高效且安全的Go代码。该项目在GitHub上开源,已经吸引了众多开发者的关注和贡献。 项目技术分析 uber_go_guide_tw项目包含了Uber公司内部使用的Go语言编写规范,这些规范不...

gitblog_00243的博客 890

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

告别混乱代码:Uber Go风格规范实战指南

在Go语言开发中,代码风格的一致性和规范性直接影响项目的可维护性和团队协作效率。Uber Go风格规范作为业内广泛认可的权威指南,为开发者提供了一套全面的编码标准。本文将带你深入了解这一规范的核心要点,帮助你写出更优雅、高效的Go代码。 ## 为什么选择Uber Go风格规范? Uber作为全球知名的科技公司,其开源的Go风格规范凝聚了众多工程师的实践经验。该规范不仅涵盖了代码格式化、命名约定

gitblog_01091的博客 467

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

Uber Go 风格指南之包命名:写出可读、可检索、无需别名的 Go Package 名称

包(package)名称是 Go 语言中暴露给使用者的第一层 API,它出现在每一次导入和每一次调用中,其命名质量直接决定代码库的可读性与可维护性。本文基于 [Uber Go Style Guide](https://link.gitcode.com/i/511d18b48472640677c53313f7aa4519) 的 [Package Names](https://link.gitcode

gitblog_01032的博客 419

Uber Go Style Guide 导读:从《Uber Go 风格指南》intro 看 Go 代码约定的核心思想与落地工具链

本文围绕 [Uber Go Style Guide](https://link.gitcode.com/i/88c33d53e4f926903fe8d902607d9962) 的开篇章节([src/intro.md](https://link.gitcode.com/i/78788d6902d8a16ea246621a118f016e))展开,讲清楚“风格约定”到底约束什么、这份指南为什么存在、它

gitblog_01103的博客 1102

Uber Go 语言编程规范:包名称

当命名包的时候,根据以下的规则来命名一个名称: 全部小写。不要使用大写或下划线。 大多数使用命名导入的情况下,不需要重命名。 简短而简洁。请记住,在每个使用的地方都用全名标识。 不要复数。例如,net/url, 而不要net/urls. 不要用"common", "util", "shared", 或者"lib".这是不好的,因此此名称不提供充足信息的。 另外请参阅Package Names和Style guideline for Go packages. ...

hero_java的专栏 173

Uber 《Go语言编程规范》学习笔记(二)

规范 包名 当命名包时,请按下面规则选择一个名称: 全部小写。没有大写或下划线。 大多数使用命名导入的情况下,不需要重命名。 简短而简洁。适当使用缩写。 不用复数。例如net/url,而不是net/urls。 不要用“common”,“util”,“shared”或“lib”。这些是不好的,信息量不足的名称。 另请参阅 Package Names 和 Go 包样式指南. 对于未导出的顶层常量和变量,使用_作为前缀 在未导出的顶级vars和consts, 前面加上前缀_,以使它们在使用时明确表示它们是全局

Eric's Blog 394

Uber/Google Golang编码标准深度分析

你好,我是俞凡,在Motorola做过研发,现在在Mavenir做技术工作,对通信、网络、后端架构、云原生、DevOps、CICD、区块链、AI等技术始终保持着浓厚的兴趣,平时喜欢阅读、思考,相信持续学习、终身成长,欢迎一起交流学习。常见的代码格式,如缩进、括号对齐、组合变量定义、行的最大长度等,不仅适用于 Go,也适用于所有语言。良好的代码风格对于开发优秀的产品至关重要,本文通过分析比较三部流传甚广的Golang代码风格指南,介绍了Go代码风格要点,并介绍了通过工具实现代码检查的方式。

残星说梦话 1201

Uber的Go语言指南

1.接口实质上在底层用两个字段表示: 一个指向某些特定类型信息的指针。您可以将其视为"type"。 数据指针。如果存储的数据是指针,则直接存储。如果存储的数据是一个值,则存储指向该值的指针。 如果希望接口方法修改基础数据,则必须使用指针传递。 2.使用值接收器的方法既可以通过值调用,也可以通过指针调用。 值接收器实现的接口,值和指针都可用。 指针接收器实现的接口,只能指针可用,值会编译失败。 3....

Salted fish in hand, I have the world. 459

Uber Go Style Guide 变更演进解读:从 CHANGELOG 回溯官方 Go 编码规范的二十年沉淀

Uber Go Style Guide([style.md](https://link.gitcode.com/i/16c29bdb3073d8d29e68c1067401dd16))是 Uber 内部维护并对外开源的一份 Go 编码规范文档,本仓库同时保留了它的完整变更记录 [CHANGELOG.md](https://link.gitcode.com/i/83d280f43d618a39e56

gitblog_00914的博客 721

对Uber Go Style Guide的理解和总结

1.不使用指向interface的指针 直接将接口作为值传递即可 传递过程中,底层数据仍然可以是指针 接口在底层的实质有两个字段:1.指向特定类型信息的指针 2.数据指针 2.接收器 ①使用值接收器的方法可以通过值或者指针调用 ②使用指针接收器的方法只能在指针或者可寻址值调用 type S struct { data string } func (s S) Read() string { return s.data } func (s *S) Write(str string) { s.da

llllleapfrog的博客 477

KubeSphere 仓库中的 go.uber.org/atomic:Go 原子类型安全封装库完整指南

`go.uber.org/atomic` 是 Uber 开源的原子操作封装库,它在标准库 `sync/atomic` 的基础上,将原始类型包装为类型安全的原子对象,提供 `Load/Store/Add/Sub/CompareAndSwap` 等更易用、更不易出错的 API。本指南以 KubeSphere 仓库中随附的 [vendor/go.uber.org/atomic/README.md](ht

gitblog_00109的博客 770
上一篇: Uber Go 语言编程规范:避免在公共结构体中嵌入类型
下一篇: Uber Go 语言编程规范:避免调用init()方法
DreamCatcher
博客等级 码龄20年 23粉丝 151原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

DreamCatcher

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值