目录

             什么是注释？

             注释的分类

        单行注释

        多行注释

             Python程序中 · 中文支持

             总结

 

什么是注释？

        通过用自己熟悉的语言，在程序中对某些代码进行标注说明，这就是注释的作用，能够大大增强程序的可读性。

注释的分类

单行注释

1）以 # 开头，# 右边的所有东西当做说明，而不是真正要执行的程序，起辅助说明作用

#!/usr/bin/python
#coding=utf-8
print("welcome to hya")  #我是注释这行我要打印这串字符


多行注释

1）多行注释类似说明的一种

'''
我是多行注释，可以写很多很多行的功能说明
        下面第一行是编译器
            第二行是字符集
            第三行我要打印这串字符
    很牛x是不是   哈哈哈。。。
'''
#!/usr/bin/python
#coding=utf-8
print("welcome to hya") 

 Python程序中 · 中文支持

1）我们首先在程序中打印一串中文

#!/usr/bin/python
#coding=utf-8
print("我是韩大本事，今年24岁了")


2）执行

[root@hya ~]# python3 python.py 
我是韩大本事，今年24岁了
####我们发现打印成功了，这是为什么呢？
提示：在脚本中设置中文字符集

3）在python的语法规范中使用的方式应该是这样

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

总结

          噗嗤，我自己都感觉自己写这篇有点太....了，不过也还是要记录一下，虽然这块并不是很重要，也不是太难。

 

注释 CTRL+K+C

取消注释 CTRL+K+U

 

    IDEA自带的注释模板不是太好用，我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家，我不是专业玩博客的，写这篇文章只是为了让大家省事。

这里设置的注释模板采用Eclipse的格式，下面先贴出Eclipse的注释模板，我们就按照这种格式来设置：

类注释模板：                                                                      方法注释模板：

    

一、首先我们来设置IDEA中类的模板：（IDEA中在创建类时会自动给添加注释）

1、File-->settings-->Editor-->File and Code Templates-->Files

我们选择Class文件（当然你要设置接口的还也可以选择Interface文件）

（1）${NAME}：设置类名，与下面的${NAME}一样才能获取到创建的类名

（2）TODO：代办事项的标记，一般生成类或方法都需要添加描述

（3）${USER}、${DATE}、${TIME}：设置创建类的用户、创建的日期和时间，这些事IDEA内置的方法，还有一些其他的方法在绿色框标注的位置，比如你想添加项目名则可以使用${PROJECT_NAME}

（4）1.0：设置版本号，一般新创建的类都是1.0版本，这里写死就可以了



2、效果图展示



二、设置方法注释模板

IDEA还没有智能到自动为我们创建方法注释，这就是要我们手动为方法添加注释，使用Eclipse时我们生成注释的习惯是

/**+Enter，这里我们也按照这种习惯来设置IDEA的方法注释

1、File-->Settings-->Editor-->Live Templates



（1）新建组：命名为userDefine



（2）新建模板：命名为*

因为IDEA生成注释的默认方式是：/*+模板名+快捷键（比如若设置模板名为add快捷键用Tab，则生成方式为

/*add+Tab），如果不采用这样的生成方式IDEA中没有内容的方法将不可用，例如获取方法参数的methodParameters(）、

获取方法返回值的methodReturnType(）



（3）设置生成注释的快捷键



（4）设置模板：模板内容如下

注意第一行，只有一个*而不是/*

在设置参数名时必须用${参数名}$的方式，否则第五步中读取不到你设置的参数名

*
 * @Author chengpunan
 * @Description //TODO $end$
 * @Date $time$ $date$
 * @Param $param$
 * @return $return$
 **/

如果使用/*生成的模板注释将会是如下效果：所以我们要去掉最前面的/*



（5）设置模板的应用场景

点击模板页面最下方的警告，来设置将模板应用于那些场景，一般选择EveryWhere-->Java即可

（如果曾经修改过，则显示为change而不是define）





（6）设置参数的获取方式

选择右侧的Edit variables按钮

PS:第五步和第六步顺序不可颠倒，否则第六步将获取不到方法



选择每个参数对应的获取方法（在下拉选择框中选择即可），网上有很多教程说获取param时使用脚本的方式，我试过使用脚本

的方式不仅麻烦而且只能在方法内部使用注释时才能获取到参数



（7）效果图

创建方法，在方法上面写：/*+模板名+Enter-->/**+Enter



 

最近在使用VS2010开发ASP.NET，突然发现想全部注释时找不到注释的快捷键，网上查了下，原来很简单，只是需要使用组合键。

注释：        先CTRL+K，然后CTRL+C

取消注释： 先CTRL+K，然后CTRL+U