【从零开始学Python】篇3-基础语法章-注释

# 这是一条单行注释print("Hello, World!")

x = 10  # 初始化变量x为10name = "张三"  # 用户姓名

# 计算用户的BMI指数# 公式：体重(kg) / 身高(m)的平方# 注意：身高需要转换为米为单位height = float(input("请输入身高(cm):")) / 100weight = float(input("请输入体重(kg):"))bmi = weight / (height ** 2)

"""这是一个多行注释的示例这里可以写很长的说明文字Python解释器会忽略未被赋值或使用的多行字符串"""def my_function():    pass

def calculate_bmi(height, weight):    """    计算身体质量指数(BMI)    参数:        height (float): 身高，单位：米        weight (float): 体重，单位：千克    返回:        float: BMI值，保留两位小数    示例:        >>> calculate_bmi(1.75, 70)        22.86    """    bmi = weight / (height ** 2)    return round(bmi, 2)

help(calculate_bmi)

x = x + 1  # 让x加1

x = x + 1  # 补偿因浮点数精度损失而产生的误差

# 计算折扣后的价格p = total * 0.9

discounted_price = total_price * DISCOUNT_RATE

# TODO: 添加异常处理# FIXME: 这里在高并发场景下会报错# NOTE: 这个算法的时间复杂度较高，后续需要优化

# 这段代码是为了应付甲方临时加的，我也不知道干嘛用的，千万别删# 上帝啊，原谅我吧，我知道这样写很丑，但deadline要到了# 如果这段代码能跑，不要问为什么# 如果这段代码不能跑，更不要问为什么

注释方式写法使用场景单行注释# 注释内容简短说明、行尾注释多行注释（模拟）"""注释内容"""临时禁用大段代码文档字符串"""函数说明"""函数、类、模块的正式文档