公司项目突然要用一个第三方服务，对接时发现只给了一堆编译好的库文件，连个函数说明都没有。同事老李一边翻着零星的注释一边嘀咕：‘这玩意儿真有文档吗？’ 其实他问的是很多开发者都遇到过的问题——闭源代码到底有没有文档？
闭源不等于没文档
很多人觉得代码不公开，那就肯定啥都没有。其实不是这样。闭源只是不让你看源码，不代表厂商不会提供使用说明。比如微软的 Windows API，虽然内核代码不开放，但官方文档写得清清楚楚，参数怎么用、返回值什么意思，全都有。
有些企业级软件更是如此。你花几十万买套系统，对方不仅给文档，还会安排培训师上门手把手教。这类文档通常叫 SDK 手册或者集成指南，专门告诉你怎么调接口、怎么配置环境。
但现实往往没那么理想
小厂或个人开发者发布的闭源工具就另说了。朋友之前接了个硬件模块，卖家只甩来一个压缩包，里面三个文件：一个 DLL、一个头文件、还有一份两页纸的 PDF，上面写着“请勿反编译”。这种就算有文档，也跟没有差不多。
更常见的情况是文档和实际行为对不上。版本更新了，接口变了，可文档还是半年前的。这时候只能靠试错，打日志、抓请求，硬生生把调用流程给“逆向”出来。
没有文档怎么办？
先别急着骂人。可以看看有没有示例代码。哪怕没文档，很多闭源包会附带 demo 程序。比如下面这种：
#include "api_sdk.h"
int main() {
init_service("your_key");
char* result = call_action(1001, "data_payload");
printf("%s\n", result);
cleanup();
return 0;
}从这段代码能看出初始化、调用、释放资源的基本流程，比干巴巴的文档还直观。
另外，留意头文件里的函数声明。像 bool connect_server(const char* host, int port, bool ssl); 这种，参数名本身就有提示作用。配合上下文猜，八九不离十。
自己写闭源也要留点人情味
有次我帮人封装一个算法库，本来想着反正不给源码，随便写写得了。结果客户反馈根本不知道怎么用。后来补了张调用流程图，加了几行注释，问题立马少了一大半。
说到底，闭源是为了保护知识产权，但不该成为拒绝沟通的挡箭牌。哪怕只是个简单的 README，写清楚依赖项、入口函数、常见错误码，都能让别人少踩不少坑。
所以闭源代码有没有文档？有的可能很全，有的形同虚设。关键是你拿到手之后，能不能从碎片里拼出完整路径。这年头，能好好写文档的，都是值得尊敬的人。