python的注释

Python09

python的注释,第1张

python中的注释一般分为单行注释、多行注释以及文档注释。

1、单行注释:在所需注释行前面加上英文#号或使用crtl+/快捷键进行操作。

2、多行注释:按住鼠标左键,选中所需注释的全部行,按住crtl+/快捷键。

3、文档注释(也可以理解为多行注释):是三对英文的双引号或单引号。

#在Python中显示中文注释和输出中文

a ="中文"

print a

d:\Python27\python.exe "D:\test\中文.py"

Process started >>>

File "D:\test\中文.py", line 1

SyntaxError: Non-ASCII character '\xe5' in file D:\test\中文.py on line 1, but no encoding

declaredsee http://python.org/dev/peps/pep-0263/ for details

<<<Process finished. (Exit code 1)

#-*- coding:utf-8 _*-

#在Python中显示中文注释和输出中文

a ="中文"

print a

d:\Python27\python.exe "D:\test\中文.py"

Process started >>>

<<<Process finished. (Exit code 0)

#-*- coding:utf-8 _*-

#在Python中显示中文注释和输出中文

a ="中文"

print a.decode('utf-8').encode('cp936')

d:\Python27\python.exe "D:\test\中文.py"

Process started >>>

中文

<<<Process finished. (Exit code 0)

扩展资料

python源代码必须完全由ASCII集合组成,如果直接在python中添加中文注释的时候,python执行时会引发异常,告知非ASCII字符语法错误。

类似:SyntaxError: Non-ASCII character.....................but no encoding declared

解决方法就是告知python使用的编码方式,告知方法是在源文件的初始部分,而且必须放在第一行,否则不起作用!

例如:

#coding=utf-8

#coding=gbk

表示文件的编码

参考资料:百度百科 - Python

我们将在本节中介绍 Python 语句,缩进以及注释,在本节的最后一部分,还会介绍作为一种特殊类型的 Python 注释Docstring 。

Python 语句是给解释器执行的指令,一条 Python 语句包含类似于如下的表达式,

你可以将 Python 语句堪称解释器解释表达式并将其结果存储在变量中的指令。类似于for , while , print 之类的语句具有特殊的含义,我们将在在后面的章节中讨论。

当你在一句语句结束时按回车键后,该 Python 语句被终止,我们可称之为单行语句。Python 中的多行语句可以通过使用连续字符 来创建,它将 Python 语句扩展为多行语句。

比如下面的例子,

这可以被称作明确的多行接续。

你还可以使用括号() ,方括号 [] 或大括号 {} 来进行隐式的多行接续。

例如,你可以使用括号来连接多行语句,

Python 语句块,例如函数,循环或类的主体,以缩进来开头。对于语句块内的每个语句,应该保持相同的缩进。当缩进不一致时,你将得到什么什么IndentationError 。

一般来说,在

Python 代码样式指南

中建议使用 4 个缩进空格。举例如下,

我们用缩进来增加程序的可读性,比如在下面的程序中,我们用两种方式来完成同一个功能,

你可以在这里看到第一个例子比第二个例子有更好的可读性。

注释用于描述程序的目的或工作工程,注释是在 Python 解释过程中被忽略的行为,它们不会干扰程序的流程。

如果你正在编写数百行代码,肯定需要添加注释,因为其他人在阅读你的代码的时候,没有足够的时间阅读每一行来理解代码的工作。程序的注释增加了可读性,并解释了代码的工作原理。

Python 注释以井号# 开始

Using hash symbol in each line can define a multi-line comment. But there is another way to add a multi-line comment in Python, that is using triple quotation marks. You can use either''' or """ .

三重引号''' 通常可以用来定义多行文档注释 Docstring ,你也可以用它来作为另外一种在 Python 中添加多行注释的方法。

Docstring 是文档字符串,它通常是 Python 函数,类,模块等的第一条语句。函数,方法和类的描述和注释位于文档字符串(文档字符串)内。

举例如下,

一目了然,Docstring 介绍了函数的功能。