eclipse怎么注释|快捷键搭配代码选中完成各类代码备注

上周赶实训代码的时候，被组员追着问eclipse怎么注释，抱着键盘在工位来回扒拉菜单，反正原先总习惯手动敲符号，敲多了单行注释符总漏打斜杠，代码一多整段备注删改能耗掉半个钟头，点开顶部source菜单栏翻找注释选项，弹窗里密密麻麻的英文选项看得脑袋发懵，随手胡乱点了个选项，直接把整段有效代码全给注释屏蔽，运行程序接连抛出报错，控制台飘出一连串红色报错文字，盯着报错信息反复核对，半天找不出代码失效的缘由，连着调试三四遍程序，才反应过来是误操作注释了核心执行代码。

选中单行代码，按下Ctrl加斜杠，整行立刻添上//单行注释，试过在代码末尾零散点击光标再按快捷键，只会在光标位置生成注释符号，没法包裹整行代码，这是某次调试小功能偶然试出来的操作，之前傻傻逐行手动输入双斜杠，一段几十行代码能磨上十多分钟，遇上临时注释测试代码，效率低的离谱。

多行不一样。

之前帮隔壁室友改项目代码，他写的工具类有近二十行逻辑代码需要批量注释，照旧单用Ctrl+/挨个点击按键，反复操作十来次，中途手滑误取消部分注释，来回返工浪费不少课余时间，后来随手勾选整块代码区块，换用Ctrl+Shift+/快捷键，一瞬间所有选中内容被/* */包裹成块注释，那一刻才恍然分清两个快捷键各自适用的场景，顺带发现撤销块注释不能继续用单行快捷键，得反过来选中区块再按一次Ctrl+Shift+/才能取消包裹符号，那一下纠正了之前混用快捷键的坏毛病，平常写测试代码频繁切换注释状态，全靠这两组按键来回调整，省去不停点开菜单栏找功能的繁琐步骤，慢慢也就不再依赖鼠标点选菜单里的注释按钮。

在xml配置文件里踩过冷门的亏，原先照搬java代码的注释快捷键，按下Ctrl+/之后符号格式完全不对，页面启动直接报配置解析异常，翻遍项目报错日志，排查大半天才记起来xml注释用，快捷键也跟着变动，没法沿用java的按键组合，只能手动输入首尾注释标记，偶尔代码行数偏多，就圈选内容后从source菜单里找comment选项完成备注，那段时间才明白不同后缀文件，注释规则在eclipse里是分开设定的。

有次误按组合键打乱注释排版，整段代码注释符号穿插在代码缝隙里，没法一键清理，只能逐行选中撤销，之后养成先框选内容再触发快捷键的习惯，不再随意在零散光标处敲击按键，哪怕只剩一两行代码要备注，也优先拖动鼠标选中内容再操作。

忘了取消注释的快捷键，单行注释依旧是重复按Ctrl+/，原本加了//的代码再次点击按键，注释符号自动清除，块注释同理重复触发Ctrl+Shift+/，就能删掉外层的注释标记，这个细节是熬夜改BUG无意间摸索出来，身边不少初学的同学都不清楚重复按键可取消注释，还在手动删除标点符号，一点点抠掉多余的注释标记。

项目自带的文档注释又是另一个路子，方法上方敲/之后回车，eclipse会自动补全参数和返回值的注释模板，其实最开始不知道这个简便写法，每一条方法说明都手动排版星号，对齐格式耗费大量精力，写完一个工具方法的文档注释就要花费数分钟，慢慢熟练后但凡需要生成接口文档的代码，全部依靠这个快捷输入方式完善备注，省去自行罗列参数说明的麻烦。

收拾桌面的时候碰倒水杯，水渍蹭在键盘按键缝隙里，之后快捷键偶尔失灵，那段时间临时改用菜单栏注释，反倒把菜单里的各类注释选项挨个摸透。