VScode 正则批量删除注释与空行：软著格式整理配置与验证

1. 软著提交前源码格式到底卡在哪软著计算机软件著作权提交时审核方对源码文档有比较明确的格式要求一般要提交前 30 页和后 30 页每页不少于 50 行且不能有大段空行、不能有注释占行。很多人第一次提交被打回原因不是代码写得不好而是源码里注释和空行太多导致有效代码行数不够、页面排版稀稀拉拉。我试过手动删注释一个几百行的文件还能忍但一个项目动辄几十个文件、上万行代码靠手删根本不现实。这时候 VScode 的正则批量替换就是最省事的方案不用装额外工具CtrlH 打开替换面板勾上正则模式一条表达式就能把整个文件的注释和空行清干净。这篇聚焦的就是这个场景用 VScode 正则表达式一次性删除所有注释与空行交付可直接复制的查找替换正则、settings.json 配置骨架以及清理前后的对比验证动作。适合正在准备软著材料、需要快速整理源码格式的开发者也适合平时想批量清理代码的任何人。下面按「问题 → 准备 → 配置 → 验证 → 排障」的顺序走一遍每一步都能直接跟做。2. 动手前TaoToken 与 VScode 环境准备清理源码本身不需要联网但如果你在整理软著的同时还要跑通项目、验证代码删注释后能不能正常编译那就需要一个稳定的模型接口来做代码检查和补全。我平时用 TaoToken 做这类辅助它提供统一的 API 入口兼容常见的对话与代码补全调用方式注册后在控制台拿到 Key 就能接入 VScode 里的 AI 编程插件。具体入口如下按需取用官网首页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址接入时填这个不带多余参数https://taotoken.net/api模型对话验证模型是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan长期编码 / Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaudeCode / Anthropic 兼容入口https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewriteVScode 这边只需要确认两件事一是版本不要太老1.70 以上都支持正则替换面板二是打开的是文件夹而不是单个文件因为批量替换要跨文件操作时得靠「在文件中替换」功能。准备工作就这些接下来直接进正题。3. 可复制的正则与 settings.json 配置骨架3.1 删除注释的三条正则按语言分VScode 的替换面板用的是 JavaScript 风格正则不同语言的注释符号不一样所以要分开处理。下面这几条是我实测下来覆盖最全的写法。删除 // 单行注释JS / TS / Java / C / C / Go 等^\s*//.*$这条会把「整行都是注释」的行删掉。注意它不处理行尾注释比如int a 1; // 说明因为那种情况删掉注释符号后面的内容容易误伤代码软著场景下建议保留行尾注释或手动处理。删除 // 块注释单行形式^\s*/\*.*\*/\s*$删除多行块注释跨行/\*[\s\S]*?\*/这条用了[\s\S]*?非贪婪匹配能跨行吃掉整个块注释。替换为空即可。要注意如果代码里有字符串包含/*这条会误伤所以执行前先备份。删除 HTML / XML 注释!--[\s\S]*?--删除 Python 的 # 注释^\s*#.*$3.2 删除空行的正则这是软著整理里最关键的一条。excerpt 里给的是^\s*(?\r?$)\n这条能用但我更推荐下面这条更直观的^\s*$\n它的含义是行首到行尾全是空白字符空格、Tab 都算然后跟一个换行符。替换为空就能把纯空行和「只有空格/Tab 的行」一起删掉。如果你用的是 Windows 换行CRLF用这条^\s*\r?\n两条的区别只在\r?加上它能兼容 CRLF 和 LF 两种换行。实测下来^\s*\r?\n在 Windows 和 Mac 上都能正常工作建议直接用这条。3.3 settings.json 配置骨架VScode 的替换面板默认不记住「正则模式」的勾选状态每次都要手动点。可以在 settings.json 里加一些辅助配置让编辑体验更顺。下面是一个骨架按需取用{ editor.find.useGlobalFindEditor: true, editor.find.globalFindClipboard: false, search.useReplacePreview: true, files.trimTrailingWhitespace: true, files.trimFinalNewlines: true, files.insertFinalNewline: true, [javascript]: { editor.defaultFormatter: esbenp.prettier-vscode } }几个关键项说明配置项作用search.useReplacePreview替换前先预览避免误删files.trimTrailingWhitespace保存时自动去掉行尾空格files.trimFinalNewlines去掉文件末尾多余空行files.insertFinalNewline保证文件末尾有一个换行search.useReplacePreview这条特别重要它会在你点「全部替换」之前把每一处匹配高亮出来让你确认没有误伤代码。软著场景下误删一行代码可能就要重新编译排查这个预览能省很多事。4. 验证请求与清理前后对比4.1 单文件清理流程打开一个源码文件按CtrlH调出替换面板点右侧的.*图标开启正则模式图标变亮即开启。然后按顺序执行第一步删块注释。查找框输入/\*[\s\S]*?\*/替换框留空点「全部替换」。第二步删单行注释。查找框输入^\s*//.*$替换框留空点「全部替换」。第三步删空行。查找框输入^\s*\r?\n替换框留空点「全部替换」。三步走完一个文件就干净了。如果文件多用CtrlShiftH打开「在文件中替换」把范围限定到src/**之类的目录一次性处理整个项目。4.2 清理前后对比验证清理前随便找个文件看行数wc -l src/main.js # 输出248 src/main.js清理后再看wc -l src/main.js # 输出156 src/main.js行数从 248 降到 156说明删掉了 92 行注释和空行。但行数变少不代表代码坏了接下来要验证功能是否正常。跑一遍构建或测试npm run build # 或 python -m pytest如果构建通过、测试全绿说明清理没有误伤代码。这一步不能省尤其是用了/\*[\s\S]*?\*/这种跨行匹配的一定要跑一遍验证。4.3 用 TaoToken 辅助检查如果项目比较大构建报错但一时看不出哪里被删错了可以把报错文件和错误信息丢给模型对话入口让它帮你定位。接入时 API 地址填https://taotoken.net/apiKey 从 API Keys 页面拿。模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 适合做这种单次排查。如果是长期要跑代码检查、Agent 自动修复用 Coding Plan 更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。5. 本篇常见错排查5.1 误删了字符串里的 //比如代码里有const url https://example.com;用^\s*//.*$不会误伤因为这条要求行首就是//。但如果你用了//.*$没加行首锚点就会把 URL 里的//后面全删掉。解决单行注释正则一定要加^\s*锚点。5.2 块注释正则吃掉了代码/\*[\s\S]*?\*/在遇到字符串里的/*时会误判。比如const s a /* b;这条正则会从/*开始匹配到下一个*/如果后面没有*/就会一直匹配到文件末尾。解决执行前先备份或者用search.useReplacePreview预览确认。5.3 空行删不干净有些空行里藏着不可见字符比如全角空格、零宽字符^\s*$匹配不到。解决先用[^\S\r\n]检查一下或者用^\s*[\r\n]配合多次替换。另外如果文件是 CRLF 换行但正则里没写\r?也会漏删加上\r?即可。5.4 替换后文件末尾多出空行删空行时如果文件末尾本来就有换行替换后可能留下一个孤立的换行符。解决在 settings.json 里开启files.trimFinalNewlines保存时自动处理。5.5 正则模式没开启这是最常见的「低级错误」查找框输入了正则但忘了点.*图标结果 VScode 把正则当普通字符串匹配一个都找不到。解决确认.*图标是亮起的。6. 整理完源码后接口侧怎么接源码清理只是软著材料准备的一环如果你在整理过程中还需要跑通项目、验证接口TaoToken 的接入方式很简单API 地址统一用https://taotoken.net/apiKey 在控制台生成。接入文档里有各语言的示例代码照着改就行https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。排障和接入相关的问题优先看 API Keys 页面和接入文档验证模型是否可用走模型对话入口长期编码和 Agent 场景用 Coding Plan。链接都在上面第 2 节列好了按需点进去即可。最后提醒一句正则替换前一定先提交一次 Git 或复制一份备份。我踩过的坑就是有一次没备份块注释正则把一段配置代码吃掉了排查了半小时才找回来。软著提交前时间紧别在这种地方翻车。