如何提高 Python 代码的可读性？五个基本技巧！
Python中有许多方法可以帮助我们理解代码的内部工作原理，良好的编程习惯，可以使我们的工作事半功倍！例如，我们最终可能会得到看起来很像下图中的代码。虽然不是最糟糕的，但是，我们需要扩展一些事情，例如：load_las_file函数中的f和d代表什么？为什么我们要在clay函数中检查结果？这些函数需要什么类型？Floats?DataFrames?在本文中，我们将着重讨论如何通过文档、提示输入和正确的变量名称来提高应用程序/脚本的可读性的五个基本技巧。1.Comments我们可以对我们的
Python 中有许多方法可以帮助我们理解代码的内部工作原理，良好的编程习惯，可以使我们的工作事半功倍！
例如，我们最终可能会得到看起来很像下图中的代码。虽然不是最糟糕的，但是，我们需要扩展一些事情，例如：
- load_las_file 函数中的 f 和 d 代表什么？
- 为什么我们要在 clay 函数中检查结果？
- 这些函数需要什么类型？Floats? DataFrames?
在本文中，我们将着重讨论如何通过文档、提示输入和正确的变量名称来提高应用程序/脚本的可读性的五个基本技巧。
1. Comments
我们可以对我们的代码做的第一件事是为我们的代码添加某些注释，但是却不能过度使用它。注释应该告诉你为什么代码可以工作或者为什么某事以某种方式完成，而不是它是如何工作的。
Python 中的注释通常使用井号 (#) 来完成，并且可以跨越单行或多行。
# Comment using the hashtag # Another comment using the hashtag
对于多行注释，我们也可以使用三个双引号。
""" This is an example of a multi-line comment """
在下面的示例中，代码中添加了一些注释，以解释某些代码行背后的工作流程和推理
2. Explicit Typing
Python 语言是动态类型的，这意味着变量类型只会在运行时检查。此外，变量可以在代码执行期间更改类型。
另一方面，静态类型涉及明确说明变量是什么类型，并且在代码执行期间不能更改。
2014 年，PEP 484 引入了类型提示的概念，后来在 Python 3.5 版本中引入，这些允许我们明确说明变量应该是什么类型。
通过添加类型提示，可以显著提高代码的可读性。在下面的例子中，我们可以轻松得到如下信息：
- 函数需要两个参数
- 文件名参数应该是字符串类型
- start_depth 参数应该是 float 类型，默认值为 None
- 该函数将返回一个 pandas DataFrame 对象
我们可以立即根据类型提示准确判断函数需要什么以及它将返回什么。
3. Docstrings (Documentation Strings)
文档字符串是紧跟在函数或类定义之后的字符串文字，Docstrings 是一个很好的方式来详细解释我们的函数做什么，它需要什么参数，它会引发的任何异常，它会返回什么等等。
此外，如果我们使用 Sphinx 之类的工具为代码创建在线文档，则文档字符串将自动被拾取并转换为适当的文档。
下面的示例显示了一个名为 clay_volume 的函数的文档字符串。
在这里，我们可以指定每个参数是什么，这比基本的类型提示更加详细，我们还可以包含有关函数背后的方法的更多信息，例如学术参考或方程式。
当我们从代码中的其他地方调用函数时，拥有文档字符串也是非常有帮助的。例如，使用 Visual Studio 编辑代码时，可以将鼠标悬停在函数调用上，然后查看该函数的功能及其要求的弹出窗口。
如果使用 Visual Studio Code (VSCode) 来编辑我们的 Python 代码，可以使用像 autoDocstring 这样的扩展插件来简化创建文档字符串的过程。该插件允许我们输入三个双引号并自动填充模板的其余部分，我们只需要关注必须填写的其他详细信息即可。
4. Readable Variable Names
很多时候，当我们编写代码时，不会太在意变量的名称，尤其是当我们急于完成某些功能时。但是如果我们的代码返回一系列名为 x1 或 var123 的变量，那么可能任谁都无法第一眼理解它们所代表的含义。
下面的示例，我们有两个变量 f 和 d。可以通过查看代码的其他部分来猜测这些含义，但这需要一定的时间，尤其是在代码很长的情况下。
如果我们为这些变量分配适当的名称，就能够知道其中一个是由 lasio.read() 调用读取的 data_file，并且很可能是原始数据，data 变量告诉我们这是我们正在使用的实际数据。
5. Avoiding Magic Numbers
魔法数字是代码中的值，它们背后具有很多无法解释的含义，并且可以表示常量。在代码中使用这些可能会导致歧义，尤其是对于那些不熟悉其中使用数字的任何计算的人。
此外，如果我们在多个地方有相同的魔法数字并且需要更新它，我们将不得不更新它的每个实例。然而如果将数字分配给正确命名的变量，则整个过程会容易得多。
在下面的示例中，我们有一个函数计算一个名为 result 的值并将其乘以 0.6。通过代码我们无法准确的知道该段代码的具体含义
如果我们声明一个变量并将该值分配给它，那么我们就有更好的机会知道它是什么。在这种情况下，它是用于将伽马射线指数转换为粘土体积的粘土与页岩的比率。
总结
通过注释和文档字符串将文档添加到我们的代码中可以大大帮助自己和其他人了解代码在做什么。确实，一开始可能感觉像是一件苦差事，但通过使用工具和定期练习，它可以成为你的第二天性。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
