什么是开发者日志？

图片来源：

Pexels，通过 Pixabay。CC0。

在计算机科学领域工作最棒的部分之一是我们的工作重心是解决问题。虽然我们许多人会开玩笑说，不断努力解决问题令人沮丧，但我们这样做是因为没有什么能比得上找到解决方案的感觉。当然，短暂的兴奋过后，我们就转向下一个问题。

我们希望我们的解决方案是另一个数据点，推动我们成为更成功和更有效的工程师。但是，当我们遇到一个旧问题，一个我们已经解决过的问题，却不记得在哪里找到允许我们解决问题的那个微小的信息时，该怎么办？成为一名工程师常常感觉有点像在过《土拨鼠日》，总是身处一个你明知道自己以前解决过类似问题的地方。我的解决方案是开发者日志。

开发者日志的益处

开发者日志背后的理念是，在你执行任务时做相关的笔记可以帮助未来的你。科技行业要求我们不断学习新技术，加深理解，并能够处理对某种工具的快速、一次性使用——这一切都是这项工作的一部分。拥有日志可以帮助你跟踪你的学习。即使你只是短暂地使用某个工具，下次你使用该工具时能够参考你的日志也可以限制肌肉记忆的丧失并提高你的回忆能力。然而，这并非它唯一的益处。

爱因斯坦的建议是“永远不要记住你可以查到的东西”，这是许多工程师铭记于心的概念。选择不记住事物可能会腾出我们大脑中的一些空间，以便专注于更宏观的问题。然而，当我们查找事物时，我们正在消耗时间和精力，并将自己从开发流程中抽离出来。开发者日志允许我们在记住一切和每次遇到它们时都查找事物之间取得平衡。如果你要查找的内容是用你自己的语言写成的，并且容易访问，那么你作为工程师的生活就会变得更轻松。

开发者日志的最终益处之一是士气。我们往往看不到我们日常的进步；只有当我们回顾一段时间时，我们才会意识到我们成长了多少。拥有成长的实际体现是一件美好的事情。也许你在一年前写下了一些东西，现在不再需要参考了。也许你已经从更简单的任务发展到更复杂的任务，或者掌握了你以前几乎无法理解的技术。开发者日志是你所做一切的绝佳历史记录。

开发者日志的类型

开发者日志是个人化的，但它们通常包含解决方案、笔记、有用的技巧以及指向资源的快速链接的混合。因为它们是为了适应个人偏好而制作的，所以它们可以采取许多不同的形式。

例如，它们可以是离线的（例如，纸质书写日志）或在线的。数字日志内容可以使用 Markup 或其他工具格式化，或者如果你喜欢，也可以使用纯文本。日志可以按时间顺序或按主题组织。最后，日志可以是公开的或私有的。

使用任何使你的日志最易于访问和使用，以便记录内容并在需要时查找内容的解决方案。幸运的是，有许多令人难以置信的开源工具可以用来促进你的开发者日志，例如各种 Linux 日志应用程序、类似 Evernote 的应用程序和命令行笔记应用程序。

日志中应该放什么

如果你不确定在开发者日志中包含什么，请考虑你经常使用或作为参考的资源类型。日志可能包括代码片段或指向存储库中特定行的链接。通常会放入指向特别有用的博客文章或教程的简单链接。我最有用的条目之一是我用来将固件刷入板载设备的流程的简要说明。

这是一个来自我的开发者日志的快速示例。去年，我注意到我经常使用的一个进程会卡住。我一直忘记在终端中手动终止它的命令，所以我把它写了下来。以下是我的日志条目的屏幕截图。它是纯文本，可离线使用且未格式化。它很简单，而且对我来说很有效。我的日志的时间顺序对我帮助很大，因为我倾向于记住我上次需要答案的时间，即使我不记得答案。