Python中'''的含义是什么?新手该如何记忆其用途?
Python中三重引号(
''')的用途详解 本质:多行字符串字面量
'''(和"""完全等价)的核心定义就是Python里的多行字符串标识,用来创建跨多行的字符串对象,里面的换行、空格会被原样保留,而且内嵌的单/双引号不需要转义,比如:poem = '''床前明月光 疑是地上霜 举头望明月 低头思故乡''' print(poem) # 输出会保留换行格式文档注释是约定俗成的用法
Python没有专门的语法用于定义函数/类/模块的文档注释,社区约定把放在函数、类、模块最开头的三重引号字符串作为文档注释(即docstring)。因为它支持多行排版,能清晰写清楚功能、参数、返回值等信息,而且可以通过对象的.__doc__属性或help()函数读取:class Calculator: '''简单的计算器类,支持加减乘除操作''' def multiply(self, a, b): '''计算两个数的乘积 参数: a: 乘数 b: 被乘数 返回: 两数的乘积 ''' return a * b print(Calculator.__doc__) help(Calculator.multiply)注意:这里的三重引号字符串本质还是字符串,只是Python的工具链会优先识别这种位置的字符串作为文档说明。
其他临时用法
偶尔会被用来临时注释大块代码(替代多行#),但这种用法并不规范,推荐使用IDE的块注释功能:''' # 临时注释掉这段代码 temp_list = [1,2,3] print(sum(temp_list)) '''
新手记忆技巧
先记住'''的核心身份是多行字符串,文档注释是它的「适配场景」——因为多行字符串的特性刚好满足文档注释需要换行、格式清晰的需求,所以才成为了写文档注释的标准方式,不是它天生就有文档注释的专属功能。
内容的提问来源于stack exchange,提问作者Kojrey
相关产品推荐
相关产品推荐

