TextMate是很多PHP开发者常用的轻量级代码编辑器,凭借灵活的快捷键配置和丰富的语法支持,能大幅提升编码效率。其中快速注释PHP代码是日常开发中使用频率很高的操作,掌握对应的技巧可以节省大量重复劳动时间。

TextMate注释PHP代码的基础规则
PHP语言的注释分为两种类型,TextMate的注释功能会适配这两种语法:
- 单行注释:使用
<?php // 这是单行注释 ?>或者<?php # 这是单行注释 ?>的语法 - 多行注释:使用
<?php /* 这是多行注释 可以跨多行 */ ?>的语法
默认快捷键操作
单行注释快捷操作
在TextMate中编辑PHP文件时,选中需要注释的单行代码,按下Command + /组合键,编辑器会自动在行首添加//符号完成注释。如果需要取消注释,再次选中已注释的行,按下同样的组合键即可移除//符号。
示例操作如下,假设我们有如下PHP代码:
<?php echo "Hello World"; $num = 10; ?>
选中第二行echo "Hello World";后按下Command + /,代码会变成:
<?php // echo "Hello World"; $num = 10; ?>
多行注释快捷操作
如果需要注释多行PHP代码,先选中所有需要注释的行,然后按下Command + Option + /组合键,TextMate会自动在选中内容的首尾添加/*和*/符号,完成多行注释。取消多行注释时,选中被/* */包裹的内容,再次按下该组合键即可。
还是以上面的代码为例,选中第二行和第三行代码后按下Command + Option + /,代码会变成:
<?php /* echo "Hello World"; $num = 10; */ ?>
自定义注释快捷键
如果默认快捷键不符合你的使用习惯,可以自行修改配置:
- 打开TextMate的偏好设置,选择键绑定选项卡
- 在搜索框中输入注释相关的关键词,找到单行注释和多行注释对应的命令
- 点击对应的快捷键区域,按下你想要设置的新组合键,保存配置即可生效
常见问题解决
快捷键没有反应怎么办
首先检查当前编辑的文件是否被识别为PHP类型,TextMate只有识别到文件是PHP语法时,才会调用对应的注释规则。如果文件后缀是其他类型,可以点击底部状态栏的语言标识,手动选择PHP语法。
注释符号不符合预期
如果发现注释添加的是HTML的注释符号<!-- -->而不是PHP的//或者/* */,说明当前语法模式错误,同样需要手动切换到PHP语法模式即可解决。
其他实用小技巧
如果需要在注释中添加调试标记,比如标注TODO或者FIXME,可以直接在注释内容中写入对应标识,TextMate会自动高亮这些关键词,方便后续查找待处理的内容:
<?php // TODO 后续需要优化这段逻辑的性能 // FIXME 这里存在空指针的风险 $result = getData(); ?>