Skip to content

日志模板

目的不是「记流水账」,而是每天给学习留一个可回看的锚点:今天学了什么、卡在哪、明天干什么。日志写得好,月底能自动长出周报与复盘,疑问攒够了就是下一篇专题文章的种子。

使用方式

  1. 文件放在本站 docs/journals/ 下,按日期 + 主题命名:2026-09-01-vue-reactivity.md
  2. 当天学习结束时填写,目标 5 分钟内完成——正文只写三件有意义的事,不要抄笔记;
  3. 写完后登记到 config.mjs 侧边栏的「学习日志」分组(texts.journals 六语言同步),并在过程记录首页的索引中补一行链接;
  4. 疑问反复出现或想透了一个点,就把它展开成正式文章(见「从日志到专题文章」)。

完整模板(直接复制)

markdown
---
title: 2026-09-01 Vue 响应式原理
description: 收获 / 疑问 / 明日计划一句话各一条
tags:
  - 学习日志
---

# 2026-09-01 Vue 响应式原理

## 一句话主题

今天学了什么?一句话说清(学到哪一课、读了哪篇、做了什么练习)。

## 收获

- 最值得记的一条:能用自己的话讲出来的才算学会
- 第二条(可选):一次顿悟、一个类比、一个可复用的结论

## 疑问与卡点

- 还没想透的问题(记录时的问题,比答案更值钱)
- 卡在哪一步、尝试过什么解法

## 明日计划

- 明天要做的具体一件事(含验收:跑通 / 读完 / 写完)

> 相关链接:[站内笔记](../frontend/vue) · [踩坑记录](./pitfalls) · [项目复盘](./retrospective)

各字段怎么填好

字段要求反例
一句话主题日期 + 主题关键词,能被搜索与回顾只写「学习记录」
收获用自己的话重述 + 一个可复用的结论,能脱离资料讲给别人听复制官方文档原句
疑问与卡点写下「问题本身 + 卡点位置」,比答案更值钱;答上来了就划掉补一句结论「暂无」
明日计划一件具体可验收的事,不含糊「继续学习 Vue」

三种长度,按需切换

类型耗时适用场景内容
极简日志2 分钟忙、碎片学习只填一句话主题 + 一条收获
标准日志5 分钟每日例行完整模板全部字段
展开日志15 分钟周末 / 阶段收尾在标准日志基础上,把某条收获写成可发布的短文

原则:宁可每天 5 分钟,不要攒到周末补 2 小时。当天的模糊细节(卡在哪、试过什么)隔夜就丢。

从日志到专题文章

日志是原材料,正式文章是产品。三个转化时机:

信号转化动作目标页
同一疑问出现 ≥ 3 次系统查证后写成「原理 / 概念」笔记对应领域页(如 前端编程语言
踩坑重现或排错超过半天按五段式写成独立条目踩坑记录
一个里程碑 / 项目结束把数周日志汇总成结构复盘项目复盘
阶段学习收尾汇总日志得周报 / 月度总结周报 / 月度总结

示例对比

偏流水账(差)

今天学了 Vue 的响应式,感觉还行,明天继续。

问题:三个字段一个都没回答——学的具体是什么、收获点在哪、明天继续学哪部分。

可回看(好)

  • 主题:Vue 3 refreactive 的取舍。
  • 收获ref 内部就是 reactive 包一层 { value },所以对象想要解构不失响应必须用 toRefs;响应式丢失的本质是「把 Proxy 拆成了普通值」。
  • 疑问reactive 对整个对象深代理,为什么官网仍推荐 ref 为主?——待查编译与心智模型差异。
  • 明日:跑一个 reactive 嵌套赋值是否触发更新的最小用例,验证深层代理行为,写进本站笔记。

写作规范速记

  • 命名 YYYY-MM-DD-主题.md,日期用学习当天;
  • 收获必须是自己的话,能解释给别人听才算数;
  • 疑问要写具体(「卡在哪一步」),别写「不懂」;
  • 所有过程记录页互相引用使用本站相对链接(./index./pitfalls./retrospective),需要展开的专题链接到对应领域页;
  • 完成后同步首页索引与 config.mjs 侧边栏。

写作规范请参阅过程记录

基于 VitePress 构建 · 内容以知识共享方式沉淀