我上个月刚接了朋友甩过来的一个本地部署项目，说是之前的开发跑路了，留下一堆源码让我帮忙撑着。
打开压缩包那一刻我整个人都傻了，几十个文件夹乱堆在一起，文件名全是新建文件夹1最终版修改这种神仙命名，代码里连个像样的注释都找不到。
更绝的是，整个项目从环境配置到接口调用，半个字的说明文档都没有。我问朋友，之前开发没留文档吗？朋友说，对方说代码就是最好的文档，这不就直接给你了嘛。
我之前遇到过没文档的项目，但这么干净的真的第一次见。干净到什么程度？连个README文件都没有，就给你一堆源码，爱咋咋地。
很多人觉得，不就是没文档吗？慢慢读代码总能读明白对吧？我一开始也这么想，不就是捋逻辑嘛，花点时间总能搞定。
结果真动手才发现，这哪里是花点时间，简直是把项目重新开发一遍都比这个快。
你要先搭环境吧？用了什么版本的Python？哪个版本的Node.js？依赖包都有哪些？全部不知道，只能一个个试。装错版本了，依赖冲突了，折腾整整一天，环境都跑不起来是常态。
就算环境跑起来了，业务逻辑全靠猜。这个参数是干嘛的？这个接口返回的字段为什么会有两个重复的？当初这么写是有特殊业务逻辑还是开发当时偷懒了？
没有文档，你只能一行一行翻代码，把整个逻辑从0到1理一遍，这个时间成本真的高到吓人。
我记得之前看到过一个行业数据，维护无文档 legacy 代码的成本，真的是从头开发一套同功能项目的2到3倍。我当时还不信，现在自己踩坑了才知道，这个数据真的没夸张。
我有个朋友在传统企业做开发，手里压了三四套这种无文档的本地部署源码，他说每天啥新需求都不用做，光是改bug就能占满一整天的工作时间。开发新功能的时候改一处崩三处，不知道哪段逻辑就埋了坑，天天加班都是常态。
放到云端的项目还好，至少有版本记录能翻，本地部署的源码很多时候就是发你一个压缩包，开发过程中的提交记录全都没了。当初为什么改这段代码，谁改的，为什么这么改，全成了悬案。
而且本地部署的项目，很多都是绑定了特定服务器环境的。换个服务器部署，路径不对、权限不对、依赖版本不对，分分钟给你抛出一堆红色报错，你连去哪找问题都不知道。
最可怕的是出问题的时候，锅全是接盘侠的。之前开发拍屁股走人了，现在出问题你接了项目，那就是你的责任。业务部门催着改，老板催着上线，你对着一堆乱麻一样的代码，连哭都找不到地方。
我上个月就碰到一个邪门的问题，用户导出报表的时候总是乱码，翻了三天代码才发现，当初开发把编码格式硬写死在配置文件里，那个配置文件还放在了服务器的临时目录里，源码里根本没带过来。
你说上哪说理去？这种坑，没有文档你根本找都找不到。
很多人觉得，接这种项目不就是为了省点钱吗？反正源码都有了，找个人维护一下比重新开发便宜。
真的算过账吗？一个开发一天工资大几百，捋代码捋一个月，那成本比重新开发一套都高了，最后还落一肚子怨气，图什么呢？
如果真的要接手别人的本地部署项目，第一件事就是要求对方把所有文档补全，从环境说明到业务逻辑，从接口定义到部署步骤，一个都不能少。别听什么“代码就是文档”这种鬼话，写代码的人自己走了三个月回来都读不懂自己写的没注释的代码，何况外人。
要是对方说补文档太麻烦，那宁愿多花点钱重新开发，也别接这个烂摊子。真的，相信我，这个隐形负债你背不起。
我现在碰到有人找我接无文档的本地源码项目，我直接就推了，不是不想赚这个钱，是赚这个钱的辛苦劲，真抵不上那点报酬。
做开发这么多年，我最大的体会就是，天下没有免费的源码，也没有便宜好占的烂摊子。看起来你拿到了现成的源码省了开发钱，实际上背后的隐形负债，能把你拖得喘不过气。
尤其是本地部署的项目，没有文档就是最大的灾难。等你真的要改需求要出问题的时候，才会发现那三倍的维护成本真不是说说而已。
这方面我了解得不够多？不对，我踩的坑足够多了，说的都是掏心窝子的话。你要是不信，大可以自己接一套试试，试过你就懂了。
你有没有接过这种没有文档的源码项目？踩过什么坑，评论区聊聊吧。