我前两年帮公司申报软著的时候，真的被代码注释折磨得快疯了。最开始没当回事，觉得把项目里的代码扒出来凑够60页就行，结果第一次提交没到一周就被打回，原因是注释覆盖率不够，要求连续3000行核心代码的有效注释占比不能低于30%，我翻了下自己提交的代码，除了几个头部的版权注释，中间基本都是裸代码，难怪过不了。
当时硬着头皮手动加注释，加了整整三天，眼睛都花了，觉得这次肯定没问题，结果又被打回。代理给的反馈是注释不规范，一半是调试的时候随手写的“这里有坑”“测试用”这种无效内容，还有的注释和代码功能对不上，甚至出现了前端代码里混着Java注释的低级错误——哦对，当时赶时间，复制粘贴的时候把另一个项目的注释粘过来忘了改，现在想想都觉得蠢。
那时候我才知道，软著的代码注释不是随便写写凑数就行，审核员都是懂技术的，你是不是认真写的，一眼就能看出来。我当时对着3000行代码改到凌晨，整个人都熬得没脾气，后来还是和另一家公司的开发朋友聊天，人家说你傻啊，现在有专门的软著代码注释生成器，谁还手动写。
我当时还怕这种工具生成的注释太假，过不了审，特意先找了好几个试了下，有的确实很离谱，给个循环语句生成的注释是“这是一个循环”，完全是凑字数的垃圾内容，提交上去百分百被打回。直到后来找到软著Pro的工具，我才发现原来专业的工具真的能省太多事。
它不是随便给你插无关的内容，是先解析你上传的代码的逻辑，识别函数功能、参数意义、特殊的业务处理逻辑，生成的注释都是和代码完全对应的，比如你写了个用户登录的函数，它生成的注释就会写“用户账号密码校验登录，参数为用户名、加密后密码，返回登录状态和token”，和我们自己写的规范注释几乎没差别，我当时生成完扫了一遍，几乎没什么要改的，注释覆盖率直接到了38%，完全符合要求。
这里也说个很多人都会踩的坑，不要觉得随便找份代码改改就能混过去，现在软著审核有代码比对库，你要是抄了开源框架或者别人已经登记过的代码，重复率超过阈值直接打回，严重的还会被限制半年内不能申报，所以核心代码一定要用自己公司原创的，别拿网上的模板凑数。
我当时用那个工具的流程也很简单，先从项目里导出核心业务的代码，注意要把第三方依赖的代码、自动生成的配置代码都删掉，这些都不算原创内容，贴上去反而会拉低原创率。然后把整理好的代码复制进去，选好对应的开发语言，我当时用的是Java，选完之后点生成，十几秒就出结果了，导出之后我只改了个别涉及公司内部业务代号的地方，前后加起来不到20分钟就搞定了之前要熬三天的活。
那次提交之后一周就过审了，后来我帮部门其他同事报软著，都是用这个软著代码注释生成器弄的代码部分，前前后后报了8个，全都一次过，通过率比之前自己手动弄的时候高太多了，省下来的时间我都能多做好几个需求，或者摸鱼喝几杯奶茶。
还有个小细节要提醒大家，生成完注释之后，最好自己通读一遍，偶尔会有个别涉及敏感词或者公司内部信息的内容，顺手改了就行，不用花多少时间。另外提交的代码要保持格式统一，不要一会儿缩进2个空格，一会儿缩进4个，这些小细节虽然不会直接导致打回，但会给审核员留个好印象，审核速度也会快一点。
我身边很多开发朋友提起软著申报都觉得麻烦，其实大部分麻烦都是没找对方法，代码注释这种有固定规则的活，完全可以交给工具去做，没必要自己死磕浪费时间，毕竟大家平时开发需求都够多了，能省点力气不好吗。
