# Python中三个双引号的含义和用法 三个双引号(`"""`)在Python中有两个主要用途，我来详细解释一下： ## 1. 多行字符串（文档字符串） 三个双引号最常见的用法是创建多行字符串，特别是作为**文档字符串(docstring)**： ```python def calculate_area(radius): """ 计算圆的面积 参数: radius -- 圆的半径（浮点数） 返回: 圆的面积（浮点数） 示例: >>> calculate_area(5) 78.53975 """ return 3.14159 * radius ** 2 # 可以这样访问文档字符串 print(calculate_area.__doc__) ``` **输出效果：** ``` 计算圆的面积 参数: radius -- 圆的半径（浮点数） 返回: 圆的面积（浮点数） 示例: >>> calculate_area(5) 78.53975 ``` ## 2. 普通的多行字符串 三个双引号也可以用于创建任意的多行字符串： ```python # 创建多行文本 message = """ 这是一个多行字符串 可以包含多行文本 不需要使用换行符\n """ print(message) # 输出： # 这是一个多行字符串 # 可以包含多行文本 # 不需要使用换行符 ``` ## 3. 与单引号的对比 ```python # 单引号 - 单行字符串 single_line = '这是单行字符串' # 双引号 - 单行字符串 double_line = "这也是单行字符串" # 三个单引号 - 多行字符串 triple_single = ''' 这是使用三个单引号 创建的多行字符串 ''' # 三个双引号 - 多行字符串 triple_double = """ 这是使用三个双引号 创建的多行字符串 """ print(triple_single) print(triple_double) ``` ## 4. 实际应用场景 ### 4.1 函数文档 ```python def process_data(data): """ 处理输入数据并返回格式化结果 Args: data: 原始数据列表 Returns: 处理后的数据字典 Raises: ValueError: 当数据为空时 """ if not data: raise ValueError("数据不能为空") return {"processed": True, "count": len(data)} ``` ### 4.2 长文本内容 ```python # 用于存储长文本内容 email_template = """ 尊敬的{name}： 感谢您使用我们的服务。 您的订单号是：{order_id} 预计送达时间：{delivery_time} 如有任何问题，请联系客服。 祝您生活愉快！ {company_name} """ ``` ### 4.3 SQL查询语句 ```python # 用于编写多行SQL查询 query = """ SELECT user_id, username, email FROM users WHERE status = 'active' AND created_at > '2023-01-01' ORDER BY created_at DESC """ ``` ## 5. 重要特性 - **保留格式**：三个双引号内的所有空格、换行符都会原样保留 - **无需转义**：在三个双引号内，单引号和双引号都不需要转义 - **文档工具支持**：Python的help()函数和各种IDE会自动识别三个双引号的文档字符串 ```python # 在三个双引号内，引号不需要转义 text = """ 这里可以包含 '单引号' 和 "双引号" 不需要任何转义字符 """ print(text) ``` ## 总结 三个双引号(`"""`)在Python中主要用于： 1. **创建多行字符串** - 特别是作为函数、类、模块的文档字符串 2. **编写格式化的长文本** - 保留原始格式，便于阅读和维护 这是Python中编写清晰文档和多行文本的标准方式，建议在需要编写详细说明时优先使用三个双引号。