如何快速地注释python代码注释

来源：蜘蛛抓取(WebSpider) 时间：2016-05-02 10:06 标签： python 注释多行代码
Sublime Text对Python代码加注释的快捷键 - iNVAiN - 博客园
一直在上补基础课，发现很多课程都用Python作为教学语言，学了一下感觉果然好，简直是用英语在写代码。（我建Python目录的时候发现去年学过一点点Python，居然一点都不记得了= =）
不过注释的问题很少有课程给你讲清楚。
原来的了解是：Python的注释有2种，#是单行，'''是多行。昨天看了才知道'''并不是严格意义上的注释，而是多行字符串，只不过当注释用的时候，反正没人用到，也就不会有作用。
不知道还好，知道以后心里就有疙瘩，放狗搜了一下找到了Sublime Text加#的快捷键：ctrl + /
单行多行都有效，生活从此轻松惬意。Python实现多行注释的另类方法
投稿：junjie
字体：[ ] 类型：转载 时间：
这篇文章主要介绍了Python实现多行注释的另类方法,本文使用的是Python多行文本功能来另类的实现Python的多行注释,需要的朋友可以参考下
Python程序的注释感觉很不合群，对于习惯了使用/**/多行注释的人来说，到Python中只能使用#号进行单行注释很痛苦。
# 这里是单行注释
其实我们可以通过多行文本定义的格式实现多行注释：
&&& # 这里是多行注释
&&& a = 50
&&& b = 10
&&& c = 10
这个方法感觉还不错，跟/**/多行注释用起来没啥区别，这在调试代码的时候很管用，可以直接使用多行文本定义符号注释掉部分代码。也许Python的多行文本定义功能本来也可以充当注释用的，只不过手册上没有明确写是用于多行注释的而已。
您可能感兴趣的文章:
大家感兴趣的内容
12345678910
最近更新的内容
常用在线小工具1326人阅读
【工作总结】（48）
Python 有三种模块导入函数1、 使用import 导入模块import modname ： 模块是指一个可以交互使用，或者从另一Python 程序访问的代码段。只要导入了一个模块，就可以引用它的任何公共的函数、类或属性。模块可以通过这种方法来使用其它模块的功能。用import语句导入模块，就在当前的名称空间(namespace)建立了一个到该模块的引用.这种引用必须使用全称，也就是说，当使用在被导入模块中定义的函数时，必须包含模块的名字。所以不能只使用 funcname，而应该使用 modname.funcname.注意：可加入下面的使Python支持中文注释#coding:gbk或#coding:utf-8或##-*- coding : gbk -*-导入系统的模块& & & &比如我在家目录下创建一个m.py的文件，我们导入了许多的系统模块，比如time，string等等。这边就类似c++里面的include#!/bin/env python
import time
import string
import socket
import threading
time.sleep(10)
print &java&导入私有的模块m.py文件#!/bin/env python
#coding:gbk
#coding:utf-8
#上面的加载是支持中文注释
def plus(a ,b):
#&&&XXX&&& 是函数的说明或使用
&&&this is a test +&&&
return a+b使用import 加载m.py模块加载#!/bin/env python
#coding:gbk
#coding:utf-8
&利用sys模块导入指定Python文件的路径&
import sys
sys.path.append(&./&)
&导入Python文件&
print m.plus(12,3)
print help(m.plus)
2、&from modname import * 模式加载模块from modname import funcname&from modname import fa, fb, fc&或者 &from modname import *&与第1种方法的区别：funcname 被直接导入到本地名字空间去了，所以它可以直接使用，而不需要加上模块名的限定&* 表示，该模块的所有公共对象(public objects)都被导入到 当前的名称空间，也就是任何只要不是以”_”开始的东西都会被导入。&modname没有被定义，所以modname.funcname这种方式不起作用。并且，如果funcname如果已经被定义，它会被新版本（该导入模块中的版本）所替代。如果funcname被改成指向其他对象，modname不能不会觉察到。&建议:1)如果你要经常访问模块的属性和方法，且不想一遍又一遍地敲入模块名，使用 from module import&2)如果你想要有选择地导入某些属性和方法，而不想要其它的，使用 from module import&3)如果模块包含的属性和方法与你的某个模块同名，你必须使用import module来避免名字冲突&4)尽量少用 from module import * ，因为判定一个特殊的函数或属性是从哪来的有些困难，并且会造成调试和重构都更困难。&#!/bin/env python
#coding:gbk
#coding:utf-8
&利用sys模块导入指定Python文件的路径&
import sys
sys.path.append(&./&)
&另外一种导入Python文件&
from m import plus
print plus(12,3)
print help(plus)3、使用内敛函数__import__除了前面两种使用import关键字的方法以外，我们还可以使用内建函数 __import__() 来导入 module。两者的区别是，import 后面跟的必须是一个类型(type)，而__import__() 的参数是一个字符串，这个字符串可能来自配置文件，也可能是某个表达式计算结果。例如&mymodule = __import__ (’module_name’)&附注:&1)模块的内容都放在一个模块文件中，如 mymodule 的内容应该放在PYTHONPATH 目录下的一个mymodule.py中，C实现的除外&2)包可以将几个模块名称空间组织起来, 如A.b 就表示在包A中的一个子模块b&#!/bin/env python
#coding:gbk
#coding:utf-8
&利用sys模块导入指定Python文件的路径&
import sys
sys.path.append(&./&)
&另外一种导入Python文件&
my = __import__(&m&)
print my.plus(12,3)
print help(my.plus)
参考资料：１、/allenblogs/archive//2055149.html２、http://blog.csdn.net/chenguolinblog/article/details/
参考知识库
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：646387次
积分：9533
积分：9533
排名：第1219名
原创：254篇
转载：90篇
译文：12篇
评论：179条
文章：12篇
阅读：13268
文章：15篇
阅读：27174
文章：17篇
阅读：22602
文章：39篇
阅读：74739
文章：24篇
阅读：62894
(2)(4)(1)(5)(11)(17)(12)(7)(3)(10)(5)(6)(6)(10)(5)(4)(12)(7)(8)(14)(23)(13)(9)(26)(10)(17)(14)(17)(32)(8)(2)(8)(2)(24)python中单行注释采用 #开头
[cc lang='python' ]
print &hello python&
#this is a comment
&&多行注释
然后python蛋疼的没有块注释，所以现在推荐的多行注释也是采用的 #比如：
# comments start
#comments end
不过这种风格和标准的Java注释很像
网上说的什么使用&"& if 0:我个人觉得很不好。。。google python style 中也是采用的#来进行多行注释
& &&代码间注释
这个就直接引用一段 google 的编程规范原文吧
意思就是 不要去刻意对齐注释，后期维护代码会增加麻烦
比如#! /usr/bin/python &这句注释的意思就是告诉LINUX/UNIX去找到python的翻译器，大部分文件都不需要这个，只在要求也执行的文件中添加。
关于蛋疼的中文编码: &# coding = utf-8 & &【注：这句代码蛋疼的必须放在第二行啊，而且多个空格都不行啊！】
&python的福利！！
python在注释中有一个非常有用的东西是 doc String ，它可以用于模块、函数和类的描述：（其实总结起来都是类）下面是一个标准的方法注释
& & &他用 &&"三个引号标识，第一行大写开头，作简要概述，句号结尾，空一行开始详细的描述。他的好处是 这些注释保存在方法的__doc__属性中，可以打印显示。这个其实和java 的doc也很相似，还记得大明湖畔的@吗
阅读(...) 评论()

我要回帖

更多关于 python 注释多行代码 的文章

 

随机推荐