使用现在分词(-ing)编写代码注释是否合适？

你用现在分词（比如# Loading data sets）标注代码小节的方式一点都不怪异，反而属于行业内非常通用且实用的注释风格，完全不需要刻意修改。

为什么这种写法没问题？ #

• 简洁高效：这种短语式注释能快速传递代码段的核心动作，无需冗余的完整句子，刚好匹配你快速标记代码各部分的需求。
• 行业普遍认可：在Python、JavaScript等主流编程语言的成熟项目中，这种注释形式随处可见，比如：

  # Parsing user input
  # Validating form data
  # Generating API response
  

• 语义关联紧密：现在分词直接对应代码正在执行的动作，阅读注释时能立刻和下方代码的行为建立关联，理解成本极低。

可选的其他风格（非必需） #

如果你想尝试不同的注释形式，也可以选择：

• 祈使句形式：# Load data sets
• 名词短语形式：# Data set loading
  但这些都只是风格差异，你的原有写法完全合规且实用，不用纠结对错。

内容的提问来源于stack exchange，提问作者Fred vh