两种
Python代码的注释主要有 两种方式 :单行注释和多行注释。
- 单行注释 :
-
使用
#
符号开头,适用于简短的说明。 -
例如:
# 这是一个单行注释
print("Hello, World!")
```
2. **多行注释** <b class="card40_2411__sup_5321" data-sup="sup">2</b>:
- 使用三对引号(`'''`或`"""`)包裹,适用于较长的逻辑或文档说明。
- 例如:
```python
'''
这是一个多行注释
可以跨越多行
用来对一段代码或者一个函数进行详细的说明
'''
def add_numbers(a, b):
return a + b
```
此外,Python还支持一种特殊的注释方式—— **文档字符串(Docstrings)** ,它是一种多行注释,用于为函数、类、模块等添加文档说明<b class="card40_2411__sup_5321" data-sup="sup">3</b>。文档字符串在函数定义中使用三个双引号(`"""`)包裹。
- 例如:
```python
def greet(name):
"""
向用户发送问候语
Args:
name (str): 用户名称
Returns:
str: 问候语字符串
"""
return f"你好, {name}!"
```
总结起来,Python支持单行注释、多行注释和文档字符串三种注释方式,开发者可以根据需要选择合适的注释方式来提高代码的可读性和可维护性。