Python 编程规范 —— TODO 注释(结合 PyCharm)

Python 编程规范 —— TODO 注释(结合 PyCharm)编程是代码和注释的统一 TODO 自然表示需要做而未做的一些待完成的事项 有助于事后的检索 以及对整体项目做进一步的修改迭代 TODO Usea hereforstrin TODO Zeke Changethisto 最好在注释中包含一个截止日期 2009 年 11 月解决 或等待一个特定

编程是代码和注释的统一;

TODO 自然表示需要做而未做的一些待完成的事项,有助于事后的检索,以及对整体项目做进一步的修改迭代。

# TODO(): Use a "*" here for string repetition. # TODO(Zeke) Change this to use relations.

最好在注释中包含一个截止日期(“2009年11月解决”)或等待一个特定事件的发生(“等到所有的客户都可以处理XML请求就移除这些代码”)。

一些基本要求和规范:

  • TODO注释应该在所有开头处包含”TODO”字符串,
  • 紧跟着是用括号括起来的你的名字, email地址或其它标识符.
  • 然后是一个可选的冒号. 接着必须有一行注释, 解释要做什么. 主要目的是为了有一个统一的TODO格式,
  • 这样添加注释的人就可以搜索到(并可以按需提供更多细节).

在 PyCharm 中,使用 Alt + 6 快捷键,可快速调出项目中的全部 TODO 注释;

  • Working with TODO in PyCharm
  • Python风格规范
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/173663.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月27日 上午8:19
下一篇 2026年3月27日 上午8:19


相关推荐

  • gawk

    gawk简介awk报告生成器,作用格式化文本输出:awk分为awk.nawk.gawk。但是linux上的awk为gawk基本用法gawk[options]'program'

    2022年8月3日
    12
  • C语言switch的用法详解

    C语言switch的用法详解C 语言 switch 的意思是多项选择的意思 如图所示 定义一个整数变量 a 的值为 2 如图 1 所示定义 a 等于 2 所以输出 case2 后面的程序 如果我们定义 a 3 的话 所以不满足 case1 和 case2 因此会输出 defalut 后面的哦 如图 2 所示通过编译运行 我们发现输入了 default 这项选择 注意 case 这一项可以无限添加的哦

    2026年3月26日
    1
  • PHP审计之POP链挖掘

    PHP审计之POP链挖掘前言续上文中的php反序列化,继续来看,这个POP的挖掘思路。在其中一直构思基于AST去自动化挖掘POP链,迫于开发能力有限。没有进展,随后找到了一个别的师傅已经实现好的项

    2021年12月13日
    73
  • AI“龙虾”爆火引年轻人排队安装,“养龙虾”真的适合所有人吗?

    AI“龙虾”爆火引年轻人排队安装,“养龙虾”真的适合所有人吗?

    2026年3月12日
    2
  • 怎么解决生理需求啊_activate pycharm什么意思

    怎么解决生理需求啊_activate pycharm什么意思最近在一直学习pythonDjangoweb开发,安装了好久的pycharm打不开了,显示如下:

    2022年8月28日
    5
  • 【云原生专题】基于Docker+Neo4j图数据库搭建企业级分布式应用拓扑图

    【云原生专题】基于Docker+Neo4j图数据库搭建企业级分布式应用拓扑图图数据库是 NoSQL 领域中的一种 在处理相关联的大数据方面比关系型数据库天然具有优势 近年来在知识图谱 金融风控 社交关系等场景中发挥了重要的角色功能 同时 图数据库在 AI 领域 天然适合诸如记忆提取 关联推理 归纳探索等场景 成为了人工智能领域不可缺少的部分 Neo4J 是比较通用和常见的图数据库 具有社区版和企业版之分 普通学习使用免费的社区版即可 Neo4J 还提供了一个 Web 访问的可视化执行与查询的界面 类似 ElasticSearc 一样 非常容易上手

    2026年3月16日
    2

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号