我不是因为喜欢写作才开始写的。

是因为卡住了。

打开网易新闻 查看精彩图片

有个Bug死活解决不了。翻遍半吊子博客、过时的官方文档、 endless 论坛帖子，花了几个小时才搞定。但有个念头挥之不去：下一个开发者不该这么痛苦。

打开网易新闻 查看精彩图片

于是我写了第一篇文章。不完美，不精致，但帮到了人。就一条回复，改变了一切。

我是Safiullah Korai，有人叫我Shahzaib。做软件工程师，也写Flutter全栈。过去几年，造App、试架构、在简洁和可扩展之间找平衡——没留神，写作成了串起所有学习的线。

技术写作不是先当作家，而是当个记录旅程的问题解决者。

为什么要写

技术写作是开发者能培养的最高杠杆技能之一。它逼你想清楚，暴露理解漏洞，帮你建立不追热度的公众存在感。

更关键的是复利效应。一篇文章可能几个月后带来机会，一系列文章能定义你的专业领域。你不是只写给别人，是在给自己攒长期资产。

打开网易新闻 查看精彩图片

第一步：从你已解决的问题开始

新手最大错误是太早碰高级话题。你不需要写复杂系统设计或分布式架构，写刚学会的东西就行。

比如：刚修的Bug、终于懂的概念、新探索的工具、犯错学到的东西。你的第一读者是过去的自己——如果过去的你觉得有用，就对了。

第二步：清晰胜过复杂

很多人觉得技术写作得听起来够技术才有价值。错了。最好的技术写作简单、清晰、直接。

砍掉不必要的术语，把想法拆成小块，能举例就举例。读者不是要佩服你，是要解决问题。