代码注释·文档
要「代码注释·文档」，自己写不利索或卡在bug上，搜半天拼不对。
有人这样说「这函数逻辑太绕了，注释写到一半卡住了，还得赶明天的提交。」
能替你选的都选好了。不想动，直接点下面「交给 AI 办」，点一下就开始做；想改，就点一下要的那个。
已替你选好想改就点一下
只有你知道的不填就先空着，成品里留【待填】
还想怎么改可以不选
高级选项一般不用动 · 这件事通常 1 分钟左右做好
示例成品全文按上面这组示例选项真跑出来的
可直接发群的版本如下：
def calculate_discount(price, discount_rate):
"""
计算折后价格。
参数:
price: 原价，不能为负数。
discount_rate: 折扣率，不能为负数，用小数表示。
例如 0.2 表示打 8 折（减掉 20%）。
0 表示不打折，1 表示价格变为 0。
返回:
折后价格 = 原价 × (1 - 折扣率)
异常:
ValueError: 当价格或折扣率为负数时抛出。
"""
# 价格和折扣率不能为负，否则业务含义不成立
if price < 0 or discount_rate < 0:
raise ValueError('价格和折扣率不能为负')
# 原价减去折扣金额，就是实际要付的钱
return price * (1 - discount_rate)
if __name__ == '__main__':
# 简单自测：100 元，8 折，应该输出 80.0
print(calculate_discount(100, 0.2)) # 80.0补充说明（可直接发群）：
- 这个函数核心公式就是：
折后价 = 原价 × (1 - 折扣率)。 - 容易绕的地方是折扣率用小数：
0.2不是“打 0.2 折”，而是“减价 20%，实付 80%”。 - 当前只拦截负数，如果业务不允许
discount_rate > 1（会出现负价格），可以自己再加一行判断。