Python使用中文注释和输出中文（原创） - morwind - 博客园
刚开始学习python，需要在Python中注释中文和输出中文，现在开始尝试；
仅为初步学习参考，高手请绕行。
-----------------------------------------------------------------------
第一步：在代码中输入以下命令，执行：
#在Python中显示中文注释和输出中文a ="中文"print a
返回错误：
d:\Python27\python.exe "D:\test\中文.py"Process started &&&& File "D:\test\中文.py", line 1SyntaxError: Non-ASCII character '\xe5' in file D:\test\中文.py on line 1, but
see http://python.org/dev/peps/pep-0263/ for details&&& Process finished. (Exit code 1)================ READY ================
第二步，加入编码格式：
#-*- coding:utf-8 &*-
#在Python中显示中文注释和输出中文a ="中文"print a
返回结果：
d:\Python27\python.exe "D:\test\中文.py"Process started &&&涓?枃&&& Process finished. (Exit code 0)================ READY ================
程序可以正确执行，但输出的仍是乱码。
第三步，查找乱码并处理：
原因：这是因为win的，命令行用的是cp936编码，而上面脚本用的是utf-8编码，因此导致乱码。
解决方法是，使用decode和encode函数对字符重新解码和编码。
#-*- 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)================ READY ================Pyhton中单行和多行注释的使用方法及规范_python
作者：用户
本文讲的是Pyhton中单行和多行注释的使用方法及规范_python，
注释可以起到一个备注的作用，团队合作的时候，个人编写的代码经常会被多人调用，为了让别人能更容易理解代码的通途，使用注释是非常有效的。
一、python单行注释符号(#)
井号(#)常被用作单行注释符号，在代码
注释可以起到一个备注的作用，团队合作的时候，个人编写的代码经常会被多人调用，为了让别人能更容易理解代码的通途，使用注释是非常有效的。
一、单行注释符号(#)
井号(#)常被用作单行注释符号，在代码中使用#时，它右边的任何数据都会被忽略，当做是注释。
print 1 #输出1
#号右边的内容在执行的时候是不会被输出的。
二、批量、多行注释符号
在python中也会有注释有很多行的时候，这种情况下就需要批量多行注释符了。多行注释是用三引号'''
'''包含的，例如：
可能有的人会说这不是和多行字符串混淆了吗，但是我看到的许多程序员也是这么用的，使用时候注意区分下就好。
三、python中文注释方法
在python编写代码的时候，避免不了会出现或是用到中文，这时候你需要在文件开头加上中文注释。如果开头不声明保存编码的格式是什么，那么它会默认使用ASKII码保存文件，这时如果你的代码中有中文就会出错了，即使你的中文是包含在注释里面的。所以加上中文注释很重要。
#coding=utf-8
#coding=gbk
提示：以上两种都可以代表中文注释，我看过的更多人使用urf-8这种的比较多。
一个好的程序员，为代码加注释是必须要作的。但要确保注释要说的都是重要的事情，像看一眼就知道是干什么的，无用的代码是不需要加注释的。以上就是这篇的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助。
以上是云栖社区小编为您精心准备的的内容，在云栖社区的博客、问答、公众号、人物、课程等栏目也有的相关内容，欢迎继续使用右上角搜索按钮进行搜索python
方法注释规范
python备注
python 注释规范、python函数注释规范、python代码注释规范、python 类注释规范、python 注释，以便于您获取更多的相关知识。
稳定可靠、可弹性伸缩的在线数据库服务，全球最受欢迎的开源数据库之一
6款热门基础云产品6个月免费体验；2款产品1年体验;1款产品2年体验
弹性可伸缩的计算服务，助您降低 IT 成本，提升运维效率
开发者常用软件，超百款实用软件一站式提供
云栖社区(yq.aliyun.com)为您免费提供相关信息，包括
，所有相关内容均不代表云栖社区的意见！帐号:密码:下次自动登录{url:/nForum/slist.json?uid=guest&root=list-section}{url:/nForum/nlist.json?uid=guest&root=list-section}
贴数:18&分页:老太太级剩女发信人: NjXuLaotai (老太太级剩女), 信区: Python
标&&题: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Mon Jul 25 23:19:36 2016), 转信 &&&& -- && ※ 来源:·水木社区 官方应用·[FROM: 223.104.3.*]
wint发信人: wint (wint), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Mon Jul 25 23:39:54 2016), 站内 && 脚本，和bash保持一致
【 在 NjXuLaotai 的大作中提到: 】
: FROM 223.104.3.*
--来自微水木3.2.0
-- && ※ 来源:·水木社区 ·[FROM: 219.143.205.*]
WS “净坛使者”发信人: libgcc (不要再叫我吃键盘|继续五年内不bg), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Tue Jul 26 11:36:50 2016), 转信 && 哪个脚本语言是用双斜线做注释的? &&&& 【 在 NjXuLaotai (老太太级剩女) 的大作中提到: 】
: 标&&题: python用井号而不是双斜线做为注释符号，是出于什么考虑？
: 发信站: 水木社区 (Mon Jul 25 23:19:36 2016), 转信
: ※ 来源:·水木社区 官方应用·[FROM: 223.104.3.*]
&&&& -- && ※ 来源:·水木社区 newsmth.net·[FROM: 111.47.10.*]
@_0发信人: rezilla (@_0), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Tue Jul 26 12:04:06 2016), 转信 && javascript和php
【 在 libgcc (不要再叫我吃键盘|继续五年内不bg) 的大作中提到: 】
: 哪个脚本语言是用双斜线做注释的?
&&&& -- && ※ 来源:·水木社区 newsmth.net·[FROM: 210.30.107.*]
doubleback发信人: doubleback (doubleback), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 01:21:18 2016), 站内 && 我日常用到的所有语言都是用#，bash，tcsh，tcl，perl，python。倒想问问为啥c偏要不一样。
【 在 NjXuLaotai 的大作中提到: 】
-- && ※ 来源:·水木社区 ·[FROM: 114.92.72.*]
haha发信人: blueape (haha), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 03:29:35 2016), 站内 && c原本只有/*...*/，本来就不是以行来分割的语言 && 【 在 doubleback (doubleback) 的大作中提到: 】
: 我日常用到的所有语言都是用#，bash，tcsh，tcl，perl，python。倒想问问为啥
c偏要不一样。 && -- && ※ 来源:·水木社区 ·[FROM: 132.212.24.*]
TERMINAL发信人: TERMINALL (TERMINAL), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 04:25:01 2016), 转信 && 哪个脚本语言是用缩进来标块的? &&&& 【 在 libgcc (不要再叫我吃键盘|继续五年内不bg) 的大作中提到: 】
: 哪个脚本语言是用双斜线做注释的?
&& -- && ※ 来源:·水木社区 ·[FROM: 104.132.1.*]
可re啊发信人: rtossystem (可re啊), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 07:54:56 2016), 站内 && 哈哈，我就喜欢这样的 && 【 在 TERMINALL 的大作中提到: 】
: 哪个脚本语言是用缩进来标块的?
-- && ※ 来源:·水木社区 ·[FROM: 116.14.52.*]
lovestar发信人: SoulMelody (lovestar), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 08:17:54 2016), 站内 && coffeescript
【 在 TERMINALL 的大作中提到: 】
: 哪个脚本语言是用缩进来标块的?
: ...................
--来自微水木3.2.0
-- && ※ 来源:·水木社区 ·[FROM: 116.243.161.*]
呸发信人: koubuyi (呸), 信区: Python
标&&题: Re: python用井号而不是双斜线做为注释符号，是出于什么考虑？
发信站: 水木社区 (Wed Jul 27 09:48:37 2016), 转信 && makefile && 【 在 TERMINALL (TERMINAL) 的大作中提到: 】
: 哪个脚本语言是用缩进来标块的?
&& -- && ※ 来源:·水木社区 ·[FROM: 101.231.208.*]
文章数:18&分页:2122人阅读
python（30）
写代码注释是一件很重要的事情，如果你写的一段函数给别人调用那么往往都需要配上一些基本的注释。写好代码可以让别人容易阅读你的代码。试想一 下：如果你在github上面找到一段你想要的代码，这段代码有200行，可能这些代码我们要进行改造，那么这时候如果代码中都没有恰当的注释，我们可能要用比较久的时间去通读一下他的代码。
相反，如果这些代码有一些恰当的注释，我们可能会更加好理解一点。学会注释是编码过程中不可或缺的一部分。那么什么样的注释才是规范的注释，才能让其他看你代码的人能快速的了解你得代码结构呢。我们今天就说一说 有关于Python的一些注释规范。
在说规范之前我们有必要先看以下Python的注释有哪些?
单行注释多行注释特殊注释
按照每一个注释进行简单的介绍(我们截选request库的一段文件)：
第一行第二行：为上述所说的特殊注释，这两个注释也几乎是在你所编写的每一个py文件中应该存在的，正常情况下第一第二行通用格式。
关于 #!/usr/bin/env python
1、必须是文件的第一行
2、必须以#!开头
3、#!/usr/bin/env python告诉LINUX/UNIX去找到python的翻译器。
关于： # -*- coding: utf-8 -*-
1、基本上在文件的第二行，在#!/usr/bin/env python的下一行
2、python interpret如何解释字符串的编码
3、当你的文件中出现中文的时候，你必须使用它
第四到第十三行：为上述所说的所行注释。多行注释，以三个引号开始，三个引号结尾。这三个引号可以使单引号也可以是双引号。
1、一般类文档，函数文档，字符串之类的用双引号，变量用单引号。
第二十一行：我们所说的单行注释，单行注释以#开头标识。
你也可以连续多次使用#单行注释来代替多行注释，但是我们并不推荐那么做。
知道了上述的注释之后，我们需要知道的是在哪些场合使用哪些注释。
第一点：为了避免麻烦，在文件的开头加上这两句。
第二点：每一个Python文件的开头，紧接着第一点所说的两行代码之后，我们往往要写上关于这个模块即这个Python文件实现的功能一些注意点，可能会发生的错误，总之你得注释要让使用它的人很明白你得代码段，比如：
requests.cookies
~~~~~~~~~~~~~~~~
Compatibility code to be able to use `cookielib.CookieJar` with requests.
requests.utils imports from here, so be careful with imports.
This is the Scrapy engine which controls the Scheduler, Downloader and Spiders.
For more information see docs/topics/architecture.rst
可能，你不看代码，都已经知道接下来的是什么了，那么你能找到上面这个注释是出自哪个文件吗?
第三点：每一个类下面加上关于这个类的说明以及用法，这样使用它的人可能都不要知道他的内部构造，就可以使用他了，我们看看这个。
第一：这个类是干嘛的?
第二：经常在什么情况下使用?
第三：如何使用?
都交待说明的很详细，你不看代码估计已经会使用了。
class HTTPAdapter(BaseAdapter):
&&&The built-in HTTP Adapter for urllib3.
Provides a general-case interface for Requests sessions to contact HTTP and
HTTPS urls by implementing the Transport Adapter interface.
This class will
usually be created by …… &&&
第四点：每一个函数下面务必加上多行注释，很有可能你的函数注释只有一行，或者两行，你可以使用单行注释，也可以使用多行注释，这里与类函数说明相当，注释中往往包含使用说明，注意点。
def __setstate__(self, state):
def has_capacity(self):
&&&Does the engine have capacity to handle more spiders&&&
return not bool(self.slot)
第五点：在必要的地方加上单行注释。这些地方不外乎
1、你不怎么理解的代码
2、别人可能不理解的代码
3、提醒自己或者别人注意的代码、重要代码
self.inprogress = set()
以上，更多的编码习惯。你可以去读一读，request的代码。
原文地址：&
你来人间一趟
你要看看太阳
和你的心上人
一起走在街上
访问：1007530次
积分：10846
排名：第1793名
原创：256篇
转载：14篇
评论：411条
阅读：31430
文章：51篇
阅读：429512他的最新文章
他的热门文章
您举报文章：
举报原因：
原文地址：
原因补充：
(最多只允许输入30个字)