最近整理旧项目,翻出来一堆缩进乱成麻花的代码文件,看着就头大。手动一行行敲空格对齐,敲到一半就想砸键盘。后来同事丢给我一个叫 CoolFormat源代码格式化工具 的小软件,说是能一键把代码排得整整齐齐。我抱着试试的心态用了一周,确实省了不少事,今天就把自己的使用过程和一些踩坑经验写下来,给同样被代码排版折磨的朋友参考。这工具主打的就是多语言代码格式化,C、C++、JAVA、C#、PHP、HTML、CSS、JS 这些常见格式都能处理,对经常接手别人代码的开发者来说挺友好。

先说下载。网上搜 CoolFormat源代码格式化工具 会出来不少下载站,建议挑那种带版本号和更新日期的页面,别点那种一堆弹窗的野鸡站。我下的是绿色版压缩包,解压后直接双击 EXE 就能跑,不用安装,这点对不想往电脑里塞一堆软件的人来说很舒服。打开之后界面比较朴素,左边是文件列表,右边是代码预览区,上面一排按钮管打开、格式化、保存。第一次用可能会觉得按钮有点多,其实常用就那几个,用两次就熟了。要注意的是,解压路径别带中文,我一开始放在桌面中文文件夹里,打开文件时偶尔会报错,换到 D 盘纯英文目录后就正常了。另外杀毒软件可能会弹提示,加个信任就行,这类小工具常见情况。
重点说说格式化。把乱糟糟的代码文件拖进去,点一下格式化按钮,缩进、换行、括号位置基本都能按预设风格重排。CoolFormat源代码格式化工具 内置了几种常见风格,比如 K&R、Allman 这些,做 Java 或者 C 的朋友应该不陌生。我拿一段缩进全乱的 JS 代码试了下,格式化后层级清清楚楚,读起来顺畅多了。它还支持批量处理,选中整个文件夹一次格式化,几十个文件几秒钟搞定,比自己一个个改快太多。不过也有个小问题,遇到语法本身有错误的文件,格式化后可能会把某些行合并得莫名其妙,所以建议格式化前先备份,或者先确保代码能正常编译。这个坑我踩过一次,一段少了个分号的代码被排得面目全非,还好有备份。

用熟了之后可以调调设置。CoolFormat源代码格式化工具 允许自定义缩进空格数、是否保留空行、括号换行方式这些,按自己团队的习惯配一次,以后格式化出来的代码风格就统一了,提交到仓库里也不会因为排版问题被同事说。我一般把缩进设成 4 个空格,括号不单独换行,跟项目规范对齐。还有个实用点,它支持命令行调用,写个批处理脚本就能在提交代码前自动格式化,适合稍微进阶一点的朋友。另外提醒一句,格式化只是排版,不会帮你改逻辑,别指望它修 bug。平时写完代码顺手格式化一下,回头自己看也舒服,代码review的时候也少挨几句说。

总的来说,CoolFormat源代码格式化工具 属于那种不起眼但用上就离不开了的小工具。免费、绿色、支持语言多,格式化速度快,对付日常代码排版够用了。新手刚开始用记得先备份、路径用英文、按项目规范调好缩进,基本就不会出岔子。如果你也经常被乱七八糟的缩进搞得心烦,不妨下一个试试,几分钟就能上手。