编码的最佳实践 (Coding Best Practices)

简介: 翻译自 https://www.thinkful.com/blog/coding-best-practices/

I - 编码的真正含义是什么

" 编码 " 的定义是指用计算机可以理解的语言输入命令,以构建网站、应用程序和软件。

简单地说,计算机编码是使用编程语言向计算机传递指令的过程。代码告诉机器要执行什么任务,以及如何执行这些任务。这些详细的指令被写在多行代码中,一个充满代码的文件 (document) 被称为脚本 (script)。

脚本指导计算机执行你所期望的行动。你必须确保你的代码是正确的,否则计算机将无法理解你的命令。每个脚本都是为一个特定的目的而设计的,从调整图像的大小到播放特定的声音或视频的任何一件事。

任何你访问的网站、使用的应用程序,或你与之互动的技术,都是按照代码工作的。事实上,即使你在某人的社交媒体帖子上点击 "赞",也会触发一个脚本,与世界分享你的行动。

你现在对计算机代码是什么样子,以及它背后的目的有一些了解了。但这并不能完全解释一个编码人员的工作。这份最佳实践清单将帮助你了解编码的内容。

II - 编码的最佳实践

当涉及到学习如何编码时,有一些最佳做法,它们围绕着这7个概念:

  1. 变量的命名规则 (Variable naming conventions)
  2. 类和函数的命名规则 (Class and function naming conventions)
  3. 明确且简洁的注释 (Clear and concise comments)
  4. 缩进 (Indentations)
  5. 可移植性 (Portability)
  6. 可重用性和可扩展性 (Reusablility and scalability)
  7. 测试 (Testing)

让我们更进一步讨论,可以提高你的编码能力、确保你形成良好的编码规则的 Tips 和技巧。在你成为一名职业编码人员的过程中,请牢记这些最佳实践。

2.1 - 变量命名规则

网络开发人员经常使用简单的变量名称,如 A1 和 B1 作为临时占位符,但后来忘记用更有意义的东西来代替它们。这使得代码的可读性降低,最终导致混乱。

你在编码时学到的第一件事是,你的变量名称应该容易理解,并清楚地代表它们所存储的数据。你命名变量的方式是使你的代码可读的关键。编码时变量命名的理念很简单:创建不言自明的变量名称,并在整个编码过程中遵循一个一致的主题。

一些类型的变量命名规则如下:

  • 多字分隔 (Multiword Delimited) - 用来分隔变量名称中的多个字,不留空白。
  • 匈牙利符号法 (Hungarian Notation) - 这种规则在变量名称的第一部分描述变量的目的或类型,接下来用剩余的描述符来表示变量的功能。在匈牙利语记法中,使用小驼峰 (camelCase) 记法来分隔单词。

2.2 - 类和函数的命名规则

为什么大多数编码证书课程包括类和函数命名的基础知识是有原因的。这是学习如何编码的一个重要方面。

类似于变量的命名规则,函数和类也应该由描述性的标题组成,如上所述,这些标题是由使用规则来划分的。使用适当的命名规则的目的是为了确保你的代码中的变量、函数和类能够很容易地相互区分开来。

2.3 - 给你的代码添加清晰简洁的注释

几乎可以保证,你的代码会随着时间的推移而被修改或更新。而且,几乎所有的开发者都会在某个时候遇到别人的代码。没有经验的程序员的一个坏习惯是在编码时包含很少的或不包含注释。

这对于团队工作的程序员来说是一个很大的挑战,因为在团队中可能有不止一个人在做某个特定模块。

编码注释是被编译器忽略的代码段。这意味着它们从未被传递给计算机,也不会被处理。它们的唯一目的是帮助程序员理解代码,特别是在将来回到不熟悉的脚本上工作时。

例如,标记复杂的部分,将代码划分为逻辑段,或设置一个提醒,提醒某个特定部分需要更新。

根据编程语言的不同,可以用不同的符号如 "#"、"!" 或 ";" 来指示编译器忽略带注释的行。

然而,建议不要太过分。过多的标题或内联注释会降低在同一模块上工作的开发人员之间的知识传递价值。

注释可以大致分为以下几种:

a). 实现注释 (Implementation comments)

b). 文件注释 (Documents comments)

2.4 - 缩进

格式化和缩进对于组织你的代码是必要的。理想的编码格式和缩进包括正确的间距、行长、续行和断行。通过在代码中采用缩进、留白和制表符,程序员可以确保他们代码是可读的和有组织的。

请记住,缩进代码的方式没有对错之分。有一些流行的观点,但没有什么是普遍遵循的。

有些人使用 2 个空格,有些人喜欢用 4 个。重要的是要与你选择的风格保持一致。坚持使用一种方法,并在整个应用程序中遵循它。

当缩进和格式化风格在脚本的中途改变时,问题和混乱才会发生。

2.5 - 可移植性

可移植性是确保你的程序功能的一个关键方面。如果你的代码包含环境参数的字面(硬编码)值,如用户名、主机名、IP 地址或 URL,它将无法在配置与你不同的主机上运行。

为了解决这个问题,你必须对变量进行 "参数化",并在不同环境中运行你的软件之前对它们进行配置。这可以用属性文件、数据库或应用服务器来控制。

此外,像 XML 文件这样的资源也必须有变量而不是字面价值。否则,每次你想把你的应用程序移植到另一个环境时,你就必须在编码时改变引用。

2.6 - 重用性和可扩展性

在编码中,可重用性是一个基本的设计目标。

因为如果模块和组件已经被测试过了,通过重复使用它们可以节省很多时间。软件项目开始时往往有一个现有的框架或结构,其中包含项目的前一个版本。因此,通过重复使用现有的软件组件和模块,你可以减少开发成本和资源。

这将直接作用于项目的快速交付,从而提高利润率。

另一个需要注意的关键方面是代码的 " 可扩展性 "。随着用户需求的变化,新的功能和改进会不断添加到一个应用程序中。因此,纳入更新的能力是软件设计过程中的一个重要部分。

2.7 - 测试

在编码时测试你的工作是软件开发的一个重要部分,应该有良好的计划。它要求在软件的实际编码开始前准备好测试案例。

此外,虽然基本的单元测试是一个很好的做法,但在 Geb Spock 和 Selenium 等工具的帮助下进行 AFT (Automated Functional Testing 自动功能测试 ) 也是很有用的。

原文链接:
https://www.thinkful.com/blog/coding-best-practices/

目录
相关文章
|
7月前
|
存储 Python
Python文件编码概念详解
Python文件编码概念详解
64 1
|
4月前
|
存储 NoSQL 测试技术
go最佳实践:如何舒适地编码
go最佳实践:如何舒适地编码
|
7月前
|
JSON JavaScript 前端开发
Golang深入浅出之-Go语言JSON处理:编码与解码实战
【4月更文挑战第26天】本文探讨了Go语言中处理JSON的常见问题及解决策略。通过`json.Marshal`和`json.Unmarshal`进行编码和解码,同时指出结构体标签、时间处理、omitempty使用及数组/切片区别等易错点。建议正确使用结构体标签,自定义处理`time.Time`,明智选择omitempty,并理解数组与切片差异。文中提供基础示例及时间类型处理的实战代码,帮助读者掌握JSON操作。
187 1
Golang深入浅出之-Go语言JSON处理:编码与解码实战
|
存储 程序员 Python
【python基础知识】15.编码基础知识
【python基础知识】15.编码基础知识
74 0
|
存储 数据库 索引
深入浅出理解base编码
深入浅出理解base编码
245 0
深入浅出理解base编码
|
计算机视觉
多媒体信息处理学习笔记-2. Multimedia Data and Coding
多媒体信息处理学习笔记-2. Multimedia Data and Coding
107 0
多媒体信息处理学习笔记-2. Multimedia Data and Coding
|
存储 缓存 C++
Python 二十三大实践、编码建议和技巧
Python 二十三大实践、编码建议和技巧
116 0
Python 二十三大实践、编码建议和技巧
hyperf| 编码实践一: 基础篇
整个团队使用 hyperf 开发已经超过半年, 积累了一些最佳实践和规约, 方便团队后续开发, 提供给大家参考~
826 0
|
编解码 Python
Python 技术篇-含中文编码的代码运行方法,(unicode error) ‘utf-8‘ codec can‘t decode问题原因及解决方法
Python 技术篇-含中文编码的代码运行方法,(unicode error) ‘utf-8‘ codec can‘t decode问题原因及解决方法
648 0
Python 技术篇-含中文编码的代码运行方法,(unicode error) ‘utf-8‘ codec can‘t decode问题原因及解决方法