Sublime Text中注释操作统一高效:1. 使用Ctrl+/(Cmd+/)添加单行或多行注释,Ctrl+Shift+/(Cmd+Shift+/)添加块注释;2. 自动识别语言语法生成对应注释符号(如//、#、等);3. 可通过Package Control安装DocBlockr、Comment-Snippets等插件增强功能;4. 支持自定义注释模板提升规范性。正确识别文件类型是关键。

在 Sublime Text 中给代码添加注释非常高效,熟练使用快捷键和技巧可以大幅提升编码效率。不同编程语言的注释方式略有差异,但 Sublime 提供了统一的注释操作逻辑。
1. 基本注释快捷键
Sublime Text 支持通过快捷键快速添加或取消注释,适用于大多数语言:
- 单行注释:选中行或把光标放在行内,按下 Ctrl + /(Windows/Linux)或 Cmd + /(Mac),该行就会被添加注释符号(如 // 或 #)。
- 多行注释:选中多行后使用相同快捷键,每行都会单独添加行注释符号。
- 块注释(部分语言支持):使用 Ctrl + Shift + / 或 Cmd + Shift + / 可添加 /* ... */ 类型的块注释,适合 C、JavaScript 等语言。
2. 不同语言的注释规则
Sublime 会根据当前文件类型自动识别注释语法:
- JavaScript/Java/C++:使用 // 行注释 或 /* */ 块注释
- Python:使用 # 注释,不支持原生块注释,但可通过插件扩展
- HTML:使用 ,快捷键同样适用
- CSS:使用 /* */
3. 使用插件增强注释功能
通过 Package Control 安装插件可提升注释体验:
微信大转盘抽奖-jQuery+PHP实现,发现很多转盘抽奖,都实现了前台部分,大部分都使用了HTML5技术,但是后台自己调整抽奖几率不方便,索性自己收集资料,在一个转盘抽奖的基础上,增加了PHP部分代码,可以对抽奖几率进行自定义,设置请参考data.php文件,相关部分给出了注释。
- DocBlockr:输入 /** 后回车,自动生成函数注释模板,支持参数、返回值等说明。
- Comment-Snippets:提供更丰富的注释片段,如 TODO、FIXME、NOTE 等高亮标记,便于后期查找。
- 安装方法:打开命令面板(Ctrl+Shift+P),输入 "Install Package",搜索插件名并安装。
4. 自定义注释格式(可选)
如果想修改默认注释行为或添加个性化模板,可通过编辑语法绑定或创建 snippet 实现:
- 进入 Tools → Developer → New Snippet…
- 编写一个缩写触发的注释模板,保存为
MyComment.sublime-snippet - 例如设置输入 note + Tab 自动生成
# NOTE: [cursor]
基本上就这些。掌握快捷键和常用插件,就能在 Sublime 中流畅地为代码添加清晰注释,提升可读性和维护性。不复杂但容易忽略细节,比如语言模式是否正确识别,会影响注释符号的生成。









