3、Python注释

文章目录

Python注释

  • 确保对模块,函数,方法和行内注释使用正确的风格:
  • Python中的注释有单行注释和多行注释:
  • Python中单行注释以#开头,例如:
#! /usr/bin/python3
#config=utf-8
#这是一个注释
print('hello Python!')
  • 多行注释用三个单引号(’’’)或者三个双引号(""")将注释括起来,例如:
  • 1、单引号(’’’)
#!/usr/bin/python3 
#coding=utf-8 
''' 
这是多行注释,用三个单引号 
这是多行注释,用三个单引号 
这是多行注释,用三个单引号 
''' 
print("Hello, World!") 
  • 2、双引号(""")
#!/usr/bin/python3 
 #coding=utf-8 
""" 
这是多行注释,用三个双引号 
这是多行注释,用三个双引号 
这是多行注释,用三个双引号 
""" 
print("Hello, World!")
### Python 注释的使用方法和语法 #### 单行注释Python 中,单行注释通过井号 `#` 实现。任何位于 `#` 后面的内容都会被解释器忽略[^3]。例如: ```python # 这是一个单行注释 print("Hello, World!") # 输出 Hello, World! ``` #### 多行注释 虽然 Python 并未提供专门的多行注释符号,但可以通过连续的单行注释或者三引号(`&#39;&#39;&#39;` 或 `"""`)来实现多行注释的效果[^2]。 以下是两种常见的多行注释方式: 1. **使用多个单行注释**: ```python # 这是第一行注释 # 这是第二行注释 # 这是第三行注释 ``` 2. **使用三引号**: 三引号既可以用来定义字符串,也可以用作多行注释。当三引号内的内容不在赋值语句中时,它会被视为注释处理[^3]。 ```python &#39;&#39;&#39; 这是一个多行注释的例子。 可以跨越多行书写。 不会影响程序运行。 &#39;&#39;&#39; """这也是一个多行注释""" ``` 需要注意的是,在实际开发中,如果三引号用于注释函数或类,则通常被称为文档字符串(docstring)。文档字符串主要用于描述模块、类或函数的目的和用法[^3]。 #### 注释的最佳实践 为了提高代码可读性和维护性,建议遵循以下注释规范: - 使用简洁明了的语言说明代码逻辑。 - 避免冗余注释,即不要重复代码本身已经表达清楚的信息。 - 对复杂算法或业务逻辑进行适当注释以便后续理解。 #### 示例代码 以下展示了如何合理运用注释提升代码质量: ```python def calculate_area(radius): """ 计算圆的面积 参数: radius (float): 圆的半径 返回: float: 圆的面积 """ if radius < 0: # 如果半径小于零则抛出异常 raise ValueError("Radius cannot be negative") area = 3.14 * radius ** 2 # 根据公式计算面积 return area ``` 相关问题
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值