关于程序员的工作日志

从工作的第一个月起，我就开始记工作日志，从刚开始的寥寥几笔，到一年半以后形式逐渐成型，自己在这方面算是略有心得，姑且做个总结。

写工作日志的必要性

1. 作为便签，防止工作跟丢

   工作之后，每天要处理的事情多而琐碎，手里一件事还没做完，又会来很多新的事，先记录到工作日志，心里有个轻重缓急，按优先级一一处理，完成一件勾掉一件，会很有成就感。

2. 便于回溯和总结

   今天做的事，可能一两个月后就记不起来了，有时候需要回溯当时做事的细节，搜索一下就能找到（报加班的时候也方便查到底哪天加了班 :joy:。

   有时候需要站在事后去看自己这周、这个月、这一年完成了些什么，能更清晰地看出自己有哪些不足，哪些值得改进，工作日志是第一手的原材料。

3. 记录常用的信息

   工作中有些信息的使用频率很高，比如一些常用的脚本和命令，又比如一些关键文档的归档路径，每次到资料里去查，其实只是想拷贝那一串字符，不如直接放到工作日志里，省时省心。

如何写好工作日志

使用称手的工具

理论上所有能记录结构化信息的工具都可以作为工作日志的载体，你甚至可以用手写的笔记本，但这里只推荐使用 Typora，理由如下：

• 在电脑上记笔记和程序员的习惯是天然吻合的，便于随时调整和修改；
• Markdown 提供了足够强大的标记语法（虽然常用的只有标题分级、有序/无序列表以及代码块），却无需考虑样式，使用它写作能让你最大限度地专注于高效记录信息，不会花费太多额外时间；
• Typora 的“所见即所得”和快速导航功能使它成为写 Markdown 文档不可缺少的辅助；
• Markdown 作为纯文本格式和通用标准，任何平台都能使用，便于归档和使用 Git 管理，甚至可以同步到 GitHub 的个人仓库中。

第三方商业笔记软件（如印象笔记和幕布）的优点是在移动端也支持得很好，但这类软件出于商业目的，通常不愿意提供将笔记作为通用格式导出的功能，个人也不愿意把重要信息完全交给一家公司托管。

如果有家公司能把基于 Markdown 的多平台云笔记软件做大做成功（意味着它不太可能倒闭，倒闭了我的信息也不会丢），我还是很愿意为之付费的。

设置合理的目录结构

通常我的工作日志以月为单位，标题就是简单的“20xx年xx月工作日志”。

每篇日志都包括这几个目录：

1. 整体计划

   首先要记录公司/部门这个月的整体计划（用简单的一两句话概括），这些信息通常能从各类会议中获得，可以随时补充更新。

   其次记录个人在这个月规划的几件重要的事，作为部门的一员，首先要确保自己的计划与部门的相匹配，因为在正确的方向上你的努力才能得到认可。有余力的情况下也可以规划一些额外目标，如个人能力提升或做感兴趣的项目。

   最后还可以加几句提醒自己的话，比如“把事情一次做对”，这个就见仁见智了。

2. 工作日志

   这里记录每天的工作信息，列工作是早上要做的第一件事，通常我会每天加一个三级标题，方便快速导航，比如“12月1日（周二）”。

   是否要加上星期几，这个因人而异，我喜欢加是因为能一眼看出一个月哪几天加班了 :smile:

   标题下面不要直接用一个列表记录所有工作，这样不够清晰，我会按照最重要的两到三块工作划分一下，比如：

   • 维护工作
     • 修复 xxx 崩溃问题
     • 上会评审 xxx 问题
     • 回复社区 issue
   • 新特性
     • 撰写接口文档（已完成 20/45，目标 30/45）
   • 能力提升
     • 学习 Kerberos 协议，整理笔记
     • 学习 CISSP 第 x 章（109-120页）

   可以用打勾或者划线的方式标记已经完成的工作。我不会再按“紧急”或“重要”对这些工作排序，这样真的很费时间，特别优先的工作加粗表示即可。

   下班的时候可能还没有完成所有的工作，这再正常不过了，把剩下的工作移到明天，用括号标记进度，就可以回家啦。

   如果没有这步转移，不仅会导致日志有很多冗余信息，还可能把重要的事遗漏掉。

3. 工作池

   工作池，或者工作队列，用于存放没有明确完成日期的工作，这些工作的紧急程度相对较低。

   我的工作日志会从上往下写，因为当前写的内容最靠近工作池，做完眼前的事情后，就可以随时从工作池补充新的工作内容。

   工作池的组织方式与工作日志相同，同样按照最重要的几块工作划分，但可以分得更细，有时间就梳理下，没时间也无伤大雅。

4. 常用信息

   存放一些经常会用到但又记不住的信息，比如常用的脚本和命令，目的是提高查询/复制粘贴的效率。

其他注意事项

• 恰当的信息密度

  所谓“恰当”，就是既不要事无巨细，影响工作效率，又不要过于简略，以至于以后读不懂。

• 记得设置 Typora 的自动保存

  日志内容丢的时候，别怪我没提醒你。

• 开始新月份的时候，记得把所有没完成的工作拷贝出来

一些感想

在华为的一年多时间，我犯过错误，也得到过褒奖，也算在这个庞杂而矛盾的世界中积攒了些许生存经验。

记录工作日志，只是想帮助自己更轻松地工作，工作占据了我们大半的人生，如果不能从工作中获得很多乐趣，希望我们至少能高效地工作，留出更多的时间陪伴家人、丰富生活。