精华内容
下载资源
问答
  • IDEA类和方法注释模板设置(非常详细)

    万次阅读 多人点赞 2018-01-11 10:41:44
    IDEA自带的注释模板不是太好用,我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家,我不是专业玩博客的,写这篇文章只是为了让大家省事。 这里设置的注释模板采用Eclipse的格式,...

        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 liu-miss
     * @Description //TODO $end$
     * @Date $time$ $date$
     * @Param $param$
     * @return $return$
     **/

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

    (5)设置模板的应用场景

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

    (如果曾经修改过,则显示为change而不是define)

    (6)设置参数的获取方式

    选择右侧的Edit variables按钮

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

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

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

    (7)效果图

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

     

    展开全文
  • 注释

    千次阅读 2019-10-01 21:58:12
    注释 在python中,通常包括3种注释,分别是单行注释、多行注释和中文编码注释 1.单行注释 在python中,使用“#”作为单行注释的符号。从符号“#”开始直到换行为止,“#”后面所有内容都作为注释的内容,并被...

    注释

    在python中,通常包括3种注释,分别是单行注释、多行注释和中文编码注释

    1.单行注释

    在python中,使用“#”作为单行注释的符号。从符号“#”开始直到换行为止,“#”后面所有内容都作为注释的内容,并被python编译器忽略。

    语法如下:

    # 注释内容

     

    2.多行注释

    在python中,并没有一个单独的多行注释标记,而是将包含在一对三引号("""······""")之间,并且不属于任何语句的内容都可以视为注释,这样的代码将被解释器忽略,由于这样的代码可以分为多行编写,所以也被称为多行注释。

    语法格式如下:

    """

    注释内容1

    注释内容2

    ······

    """

     

    转载于:https://www.cnblogs.com/Yu-Mofei/p/11502610.html

    展开全文
  • linux2.6.1内核源码注释

    万次下载 热门讨论 2014-03-10 15:21:33
    包含LINUX内核同步、信号、内存、调度、文件系统、网络系统、时钟等部分的源码注释。前后历时三年,算是干货。
  • Linux2.6.24内核注释

    千次下载 热门讨论 2014-05-29 22:42:05
    所有注释都是中文,您可以与标准2.6.24内核进行比较,看看具体的注释内容。 针对2.6.24注释的时间比较短,内容不多,抱歉,请不要拍砖。更多的注释是针对linux2.6.11.12内核的,您可以通过...
  • VScode注释与取消注释快捷键

    万次阅读 多人点赞 2018-09-05 10:05:24
    注释 CTRL+K+C 取消注释 CTRL+K+U

    注释 CTRL+K+C

    取消注释 CTRL+K+U

     

    展开全文
  • 优秀的程序员真的不写注释吗?

    万次阅读 多人点赞 2020-05-11 07:02:23
    我在很多地方看到这样一个观点,“请停止写注释,因为只有烂的代码才需要注释。”这个观点非常巧妙,它让我想起了孟子的一句话,“杨氏为我,是无君也;墨氏兼爱,是无父也。无父无君,是禽兽也。” 动不动就骂别人...

    我在很多地方看到这样一个观点,“请停止写注释,因为只有烂的代码才需要注释。”这个观点非常巧妙,它让我想起了孟子的一句话,“杨氏为我,是无君也;墨氏兼爱,是无父也。无父无君,是禽兽也。”

    动不动就骂别人是“禽兽”,我总觉得有点不妥,这很不符合孟子的浩然之气啊。有些大牛也有孟子这样的觉悟,如果有人要他给自己的代码加上注释,就好像是对他的一种侮辱:“我的代码写得这么优雅,你难道看不懂吗?注释是多余的!”

    我必须得承认,每个程序员都应该有一颗追求“优雅”的心,力争自己的代码更易阅读和理解——不只是针对机器,还有我们程序员同行。但不是每个程序员在一开始都能写出“高标准”的代码的,就好像不是所有君王和百姓都能搞清楚孟子的治国齐家理念的。

    在我刚回洛阳的那段时间,过得非常痛苦。因为我刚接手了别人留下的一个项目,关于大宗期货交易的。后端代码是用 Java 写的,但有很多 bug 在里面,动不动就资金结算失败,甚至内存溢出,要解决这些问题,只有一个办法,就是彻底搞懂这些代码。

    否则,根本无从下手。这就好像,你和朋友开车出去自驾游,去很远很远的地方,朋友开累了,需要休息,这时候,如果你没考过驾照,那就抓瞎了,只能把车停路边,等朋友的疲劳消退了,才能继续上路。

    我就抓瞎了。凭良心说,前同事留下的代码是精彩绝伦的,如果换做是我来写,真不一定能写得出来。毕竟大宗期货交易本身还是有点难度的,需要竞价撮合,这个业务理解起来比股票还要复杂些。

    股票涨了就赚,跌了就亏。期货不同的,买涨能赚,买跌也能赚。不过业务上的复杂还是次要的,重要的是代码里的注释非常稀有,就好像詹姆斯高斯林头上的发丝一样稀有。

    况且,国内程序员的英语功底你懂的,变量、方法、类、接口、枚举的命名无法做到真正意义上的名如其意。再加上,有些方法的行数多达三四百行,从头看到尾,看得只想捶自己。

    没办法,我的解决办法就是,看懂一行就加一行注释,毕竟注释总比代码要容易理解啊。就好像,我们在调用一个不熟悉的 API 时,只要代码的文档说清楚它是干嘛的,我们就可以用,就敢用,至于实现的细节,暂时没有理解也没关系。

    差不多花了两个月的时间(非常漫长、非常煎熬)吧,我总算是把项目中核心的代码给研究清楚了。搞清楚之后,那些之前怎么改都改不掉的 bug 也就迎刃而解了。

    这也就是为什么,我倡导大家去读源码的一部分原因了,除了学习,读源码是解决 bug 的杀手锏。要读懂源码,注释是必不可少的。不信,你看看 Java 的源码,每个变量、每个方法、每个类,注释都非常详细,详细到你替源码的作者感到心累。

    在我看来,Java 源码的作者绝对是这个世界上最优秀的程序员,连他们都写注释,那些声称“请停止写注释”的号召者是不是要啪啪啪地打脸,直到打肿为止。

    不要怀疑自己,写注释并不会证明你的代码就是烂代码。我相信,你应该买过电子产品,比如说鼠标、键盘、耳机、手机等等,所有的产品包装里除了产品本身,使用说明书是必不可少的。我就问一句,“手机没有使用说明书,咱这些后浪还能不会用?”

    写注释不是我们的错,软件本来就是复杂的。尤其是我们这些英语不是主力语言的人来说,注释显得尤为重要。我可能属于记忆力不好的那一种,隔个十天半个月,再去回头看那些我自己敲的代码,有时候真有点见着陌生人的感觉:“这代码是我写的吗?怎么有点面生啊?”

    大部分人写的代码都要升级重构,对吧?不论是语言本身版本的升级,还是我们自身能力的成长。假如在升级重构的时候,没有这些注释的帮助,真有点爬泰山的感觉,累啊,亲。

    再者说,大牛也不敢保证自己的代码是没有问题的,对吧?但注释是不会骗人的,它的意义是明确的。你可能会忘记代码是干嘛的,但我敢保证,注释能够唤醒你的记忆。

    写出好的、有意义的注释其实是有难度的,就像写代码一样。在追求卓越的路上,代码和注释其实是相辅相成的。注释会让你的代码更易阅读,代码会让你的注释更富有逻辑。

    即便是你的代码已经优雅到不需要注释,那只是在你的层面上。对于你的同事,你代码后来的负责者,就不一定了。所见略同的英雄并不会很多,你以为很优雅的代码没准在别人眼里就是一坨垃圾,而你的注释很可能会帮助别人“恍然大悟”,明白代码的意义。乖乖地写注释吧,对你对别人都有好处。

    另外,我想说一句,注释就好像是代码的一个蓝图,也或者是对代码的一个总结。在你写代码之前,脑子里肯定要想清楚你要实现什么,怎么实现,把这些作为注释写下来绝对可以帮助你写出更优雅的代码。在代码写完之后,通过注释进行总结,还能对代码进行一些升华,没准还能在总结的过程中想到更好的代码方案。

    我还见到有大牛信誓旦旦地说,写注释就好像是给不会游泳的人扔一个救生圈,他永远也学不会游泳。咋眼一看,这句话说得很有道理,对吧?在大牛们看来,要让一个新人快速成长,最好的办法就是把没有注释的代码扔给他看。

    纯属扯淡,恐怕这个新人没入门就放弃了吧?我已经三十一岁了,不,我已经十八岁了,还不会游泳呢?别听那些大牛们的鬼话,我就不信,他自己没写过注释。

    总之一点,注释并不会妨碍你写出优雅简洁的代码,它只是程序固有的一部分而已

    如果觉得文章对你有点帮助,请微信搜索「 沉默王二 」第一时间阅读。本文已收录 GitHub,传送门~ ,里面更有大厂面试完整考点,欢迎 Star。

    我是沉默王二,一枚有颜值却靠才华苟且的程序员。关注即可提升学习效率,别忘了三连啊,点赞、收藏、留言,我不挑,嘻嘻

    展开全文
  • VS 注释多行与取消多行注释快捷键

    万次阅读 多人点赞 2017-04-13 17:12:10
    最近在使用VS2010开发ASP.NET,突然发现想全部注释时找不到注释的快捷键,网上查了下,原来很简单,只是需要使用组合键。 注释: 先CTRL+K,然后CTRL+C 取消注释:先CTRL+K,然后CTRL+U ...
  • MySQL 添加注释(comment)

    万次阅读 多人点赞 2016-10-01 19:18:03
    在MySQL数据库中, 字段或列的注释是用属性comment来添加。创建新表的脚本中, 可在字段定义脚本中添加comment属性来添加注释。示例代码如下:create table test( id int not null default 0 comment '用户id' ) ...
  • 2018年5月23日1 创建表的时候写注释create table test1(field_name int comment '字段的注释')comment='表的注释';2 修改表的注释alter table test1 comment '修改后的表的注释';3 修改字段的注释alter table test1 ...
  • html——注释(单行注释 多行注释

    万次阅读 多人点赞 2018-07-26 21:22:49
    --这是单行注释--> <!--  这是多行注释  这是多行注释  这是多行注释 --> JS/jQuery注释: //这是单行注释 /*  这是多行注释  这是多行注释  这是多行注释 */ css注释: /*这是...
  • VS Code注释快捷键

    万次阅读 多人点赞 2018-12-24 11:20:45
    单行注释: Ctrl + / 或先按CTRL+K,再按CTRL+U 取消单行注释: Ctrl + / 或先按CTRL+U,再按CTRL+K 块注释 Alt + Shift + A
  • IntelliJ IDEA设置类注释和方法注释带作者和日期

    万次阅读 多人点赞 2019-09-18 20:28:56
    当我看到别人的类上面的多行注释是是这样的: 这样的: 这样的: 好装X啊! 我也想要!怎么办呢? 往下瞅: 跟着我左手右手一个慢动作~~~ File--->Settings---->Editor---->File and Code ...
  • Python多行注释/取消注释快捷键

    万次阅读 2019-07-22 10:48:25
    step1:选中需要注释/取消注释的所有代码 step2:按快捷键 系统 快捷键 Mac command + / Windows Ctrl + /
  • python-注释和取消注释多行程序

    万次阅读 多人点赞 2018-09-13 15:56:21
    在程序中,有时候想把多行程序注释掉,一行一行的注释比较麻烦,那么可以多行注释吗,可以,有如下几种方法: 1.选中要注释的段落,按下ctrl+/,效果如下: 再按一下ctrl+/,取消注释 2.将一整段用三个双引号...
  • 如题,使用idea的时候,因为它预定义的注释样式不尽人意,但还好的是支持自定义模板。 自定义模板 File->Settings 图一 然后搜索Live Templates ,之后添加一个自己的模板组,我的是myGroup,然后是添加...
  • idea生成类注释和方法注释的正确方法

    万次阅读 多人点赞 2017-11-01 01:42:41
    生成类注释 生成类注解模板 生成方法注释 生成方法注解模板 最近从eclipse转idea了,第一步当然是配置快捷键,模板等。但是!发生了一件贼蛋疼的事情,竟然一直找不到正确添加方法注释的方法! 最后自己摸索到了,...
  • 解决:xml文件单行注释、多行注释问题

    万次阅读 多人点赞 2019-09-18 15:48:10
    【解决:xml文件中的单释、多行注释问题】 第一种(单行): <!-- 注释内容 --> 第二种(多行): <!-- 注释内容(无其他注释符) ...
  • Java注释

    万次阅读 多人点赞 2019-09-28 22:23:28
    定义 用于解释说明程序的文字 分类 单行注释 格式: // 注释文字 ...注释的内容在程序编译的时候会被忽视,不会产生目标代码,注释的部分不会对程序的执行结果产生任何影响。 注意事项 多行和文档注释都不能...
  • Eclipse 中的两种注释方法: (1)多行注释 (2)单行注释 一、 多行注释快捷键 1:添加注释 Ctrl+Shift+/ : 添加/* */注释  示例: 选中代码块后按下快捷键即可 /* float size = 0.0f;  float pct = 0.0f;  try...
  • 错误现象:注释乱码,查了好多,肯定是编码显示问题: 现象如图所示: 网上找了很多解决办法,都是很多年前的了,解决起来太麻烦。最后我在这里官方支持文章中找到了答案: Unfortunately, the code page encoding ...
  • Python 中的注释有多种,有单行注释,多行注释,批量注释,中文注释也是常用的。python注释也有自己的规范,在文章中会介绍到。注释可以起到一个备注的作用,团队合作的时候,个人编写的代码经常会被多人调用,为了...
  • Idea 添加注释:类注释、方法注释(可获取参数)

    万次阅读 多人点赞 2018-11-15 15:01:07
    Idea 添加注释:类注释、方法注释注释方法注释注释 File–Setting–Editor–File and Code Templates–Class: 注释模板:/** * * *@description: *@author: Andy *@time: ${DATE} ${TIME} * */ ...
  • idea设置类注释和方法注释模板

    万次阅读 多人点赞 2018-01-16 10:07:27
    1、设置类注释模板 这样在定义类时,都要多输入类的描述。不想的话,可以删去 ${description} 2、方法注释模板 先新建模板组,名字自己起。 然后选中自己的模板组,在模板组下新建模板 如下图给...
  • java注释分为3种 单行注释 // 注释内容 多行注释 /* 注释内容 */ 文档注释 /** 注释内容 */
  • Java 注释

    万次阅读 2019-01-22 14:49:37
    (一)注释的重要性  编写程序的时候,总需要为程序添加一些注释,用以说明某段代码的作用,或者说明某个类的用途,某个方法的工能,以及该方法的的参数和返回值的数据类型以及意义等  程序注释的作用非常大,很...
  • SQL单行注释和多行注释

    万次阅读 多人点赞 2018-07-03 20:24:11
    单行注释:-- 例如--单行注释 SELECT * FROM talbe;多行注释: /* */ 例如:/* 此处 为多行注释内容 */ SELECT * FROM table;
  • 注释的内容不会出现在字节码中,即java编译器编译时会跳过注释语句,在java中根据注释的功能不同,主要分为单行注释、多行注释和文档注释。 1,单行注释 单行注释是以“//”开头的后面的内容就是注释。 2,多行注释 ...
  • IntelliJ IDEA添加注释常用的快捷键

    万次阅读 多人点赞 2018-07-24 09:38:34
    IDEA可以使用快捷键添加行注释Ctrl+/、块注释Ctrl+Shift+/,还可以快速生成类注释、方法注释等,下面就介绍这几种快捷键的用法. [1]行注释Ctrl+/ 首先你的光标要处于这一行,处于这行的哪个位置都可以,按Ctrl+/,就...
  • 给json加注释

    万次阅读 2019-06-29 19:33:57
    我们要知道的是在json文件中用传统的注释格式(// /**/)进行注释,是不符合json规范的。 json里面有自己约定俗成的注释规范。 1、在json文件中,采用"//",其value就是添加的注释内容。 { "//": "设置起始刻度, ...
  • 注释与嵌套注释

    千次阅读 2017-11-23 21:32:34
    大家在写程序的时候是不是经常都会注释呢,反正我是有这么一个习惯,因为哪怕是自己写的程序,过个两三天自己看都得花一番功夫,所以注释是一个好习惯。  我们注释一般都是用 /*这是一个注释*/ 这种方法,而我在写...

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 2,083,205
精华内容 833,282
关键字:

注释