논평

Comments

1, comments

1.1, block comments

"#" 기호 뒤에 공백이 있으며, 문단은 빈 줄로 구분됩니다. ("#" 기호도 필수입니다. )

# 块注释
# 块注释
#
# 块注释
# 块注释

1.2. 라인 주석

은 공백 두 개 이상으로 구분되어야 합니다. 의미 없는 주석을 사용하지 않도록 주의하세요.

주석은 키에 작성하는 것이 좋습니다. 코드의 일부(또는 더 복잡한 부분) 주석을 작성해 보세요

# 正确的写法
x = x + 1  # 边框加粗一个像素
# 不推荐的写法(无意义的注释)
x = x + 1 # x加1

2. 문서 주석(Docstring)

문서로서의 Docstring은 일반적으로 모듈 헤더에 나타납니다. 부서, 함수 및 클래스의 헤더는 Python에서 개체의 __doc__ 개체를 통해 문서를 얻을 수 있도록 편집기 및 IDE에서도 Docstring을 기반으로 자동 프롬프트를 제공할 수 있습니다.

app = create_app(name, options)
# =====================================
# 请勿在此处添加 get post等app路由行为 !!!
# =====================================
if __name__ == '__main__':
    app.run()

# -*- coding: utf-8 -*-
"""Example docstrings.
This module demonstrates documentation as specified by the `Google Python
Style Guide`_. Docstrings may extend over multiple lines. Sections are created
with a section header and a colon followed by a block of indented text.
Example:
    Examples can be given using either the ``Example`` or ``Examples``
    sections. Sections support any reStructuredText formatting, including
    literal blocks::
        $ python example_google.py
Section breaks are created by resuming unindented text. Section breaks
are also implicitly created anytime a new section starts.
"""

#  不推荐的写法(不要写函数原型等废话)
def function(a, b):
    """function(a, b) -> list"""
    ... ...
#  正确的写法
def function(a, b):
    """计算并返回a到b范围内数据的平均值"""
    ... ...