python - 使用注释#'s 作为装饰以获得更好的视觉识别 - 这是不好的做法吗?
问题描述
我正在编写一个非常重复的代码。我正在使用 selenium 启动 webdriver 来推断 PLC 控制器通过其 IP 地址生成的 javascript 数据。该脚本是一个 GUI,允许用户轮询来自 PLC 的数据,包括描述性名称、输入、输出等。
我的问题是:在数千行代码中,为了更容易地区分代码而使用 # 作为视觉对象是不好的做法吗?请看下面的例子:
示例 1 - 创建标题
###################################################################
# List Definition for (AI) with the point name stored in index[0] #
###################################################################
self.ai_ain0_lst = ['Spindle FORCE']
self.ai_ain1_lst = ['PT-47']
self.ai_ain2_lst = ['PT-44']
self.ai_ain3_lst = ['LOAD CELL']
self.ai_ain4_lst = ['Ring Force Command']
self.ai_ain5_lst = ['Back Pressure Command']
self.ai_ain6_lst = ['PT-45']
self.ai_ain7_lst = ['PT-42']
示例 2 - 在代码中装箱
# Logo Image ##################################################
tech_logo = PhotoImage(file=path_to_folder + "tech_logo.png") #
image_label = Label(self, image=tech_logo) #
image_label.image = tech_logo #
image_label.grid(row=0, column=4, pady=10, padx=10, sticky=N) #
###############################################################
我仍然在整个代码中适当地使用#s 以供其他人跟进,但是对于重复的东西,我一直在创建巨大的标题(示例 1),并将它们向左缩进一次,以便我可以在编辑器中折叠代码。这在编码社区中可以吗?皱眉?或者,只要代码有效并且在必要时有注释,就没有人真正关心?
解决方案
由于缩进在 python 中是有意义的,所以像这样使用缩进是在自找麻烦。
Python 为您提供包、模块、类、方法和函数,以允许您构建代码。尝试将您的代码重构为这些结构,以便您的代码,而不仅仅是您的文本,易于理解。
推荐阅读
- r - 两列 R 数据框到命名列表
- tfs - TFS2017 更新 1 中构建定义中的自定义条件
- ionic-framework - Ionic 应用程序在 0.005% 的用户启动画面后卡住
- rest - 响应“GET”方法状态的最佳 REST 实践?
- javascript - 为什么函数 javascript 给我相同的值
- git - 我可以判断当前提交是否是新分支中的第一个提交
- azure - 如何为 IDP 用户分配 Keycloak 角色
- javascript - Javascript日期验证?
- sql - TFS 升级错误:TF400255:本地机器上不存在 SQL 实例 MSSQLSERVER
- python - 从图像中删除边框