前两年我在一家做企业SaaS的创业公司待着，行政没人懂软著申报，技术部又都觉得整申报材料是浪费时间，这活基本就落到我这个半懂技术半懂行政的负责人头上。前两次申报我完全是摸着石头过河，印象最深的就是卡代码注释，整整折腾了快一个月才过，现在想起来都头大。
第一次报的时候我以为注释就是凑数，随便找了个通用的注释插件跑了一遍，3000行代码凑了快40%的注释，信心满满交上去，结果第三天就被打回了，理由是注释和代码逻辑、申报的功能点完全不匹配。我翻了下打回的标注，有一行是调用企业微信推送消息的代码，插件生成的注释是「执行函数操作」，完全和我提交的说明书里的「内部消息自动推送」功能搭不上边，审查员直接标了个疑似造假。后来我熬了两个大夜，一行行对着说明书改注释，生怕哪行又对不上，改完眼睛都快花了。
后来踩的坑多了我才摸清楚，软著的代码注释根本不是随便凑就行，要求其实挺细的：首先覆盖率要在30%以上，不能太低也不用太高；然后注释要对应代码的实际功能，最好和你提交的说明书里的功能点能对应上，不能写无关内容；还有不能有敏感词、内部标记、吐槽内容，之前有个同行提交的代码里带了个「// 产品脑残需求临时实现」，直接被打回，还留了个不良记录，半年内都不能提交申请。最烦的是不同开发语言的注释要求还不一样，Python不能全用三引号的文档字符串凑数，Java的注释不能混着太多TODO标记，这些没人告诉你的话，踩坑是迟早的事。
去年年底公司要申报高企，一下子要报6个软著，截止日期只剩半个月，我正发愁要熬多久的夜，在开发者社群里吐槽的时候，有人给我推了软著代码注释生成器，说专门针对软著申报的规则做的，比自己瞎弄快太多。我一开始还怕生成的注释太假过不了，抱着试试的心态传了个客户管理系统的核心代码上去，选了Java语言，又填了几个我之前整理的核心功能点，没想到两分钟就生成好了。我翻了十几行，完全惊到了，比如用户权限校验的代码段，生成的注释是「// 校验当前登录用户的角色权限，判断是否可访问客户数据模块」，和我说明书里写的功能完全对应，一点都不敷衍，注释覆盖率刚好卡在34%，完全符合要求，连格式都给我调好了，没有多余的空行，也没有乱七八糟的标记。
我自己花了二十分钟扫了一遍，把几个涉及公司内部业务代号的地方改了改，就直接导出用了。后来6个软著的代码材料，我前后加起来才花了不到3小时，要是放在之前，我自己写至少要一周，还不一定能一次过。那批软著提交之后半个月就下了证，完全没耽误高企申报的时间，省了我好大的事。
后来我也给身边不少做开发、做行政的朋友推过这个工具，大家反馈都不错，我也摸出了几个用这个工具的小技巧。首先你上传代码的时候不要传测试代码、第三方依赖的代码，就挑你自己写的核心功能模块，比如登录、核心业务逻辑、数据处理这些，凑够3000行就行，生成的注释会更贴合你的功能点。要是你不确定自己整理的其他材料合不合规，也可以顺带着用软著Pro的材料校验功能，连说明书的格式、说明书和代码的匹配度都能帮你查，省得你提交之后再被打回补材料，一来一回最少耽误一周时间。
我见过不少人为了省点小钱，去网上找那种免费的通用注释插件，或者直接抄别人的注释模板，最后反而耽误事。通用的注释插件是给开发团队维护代码用的，生成的都是参数说明、返回值说明这些，和软著要求的功能说明完全不是一回事，很容易和你提交的说明书对不上。抄别人的注释模板就更不靠谱了，每个人的代码逻辑都不一样，你抄的注释和你的代码根本不搭，审查员每天看那么多材料，一眼就能看出来有问题，到时候被认定为材料造假，反而得不偿失。
其实现在很多公司申报软著都是为了拿补贴、报项目、申请资质，往往卡着截止日期去弄，要是因为代码注释这点小事耽误了时间，错过补贴或者项目申报期，亏的可不是一点半点。我现在每次碰到有人问软著材料怎么整，第一个就推这个注释生成器，省下来的时间干点啥不好，犯不着跟几千行代码熬好几个大夜。