日志模板
目的不是「记流水账」,而是每天给学习留一个可回看的锚点:今天学了什么、卡在哪、明天干什么。日志写得好,月底能自动长出周报与复盘,疑问攒够了就是下一篇专题文章的种子。
使用方式
- 文件放在本站
docs/journals/下,按日期 + 主题命名:2026-09-01-vue-reactivity.md; - 当天学习结束时填写,目标 5 分钟内完成——正文只写三件有意义的事,不要抄笔记;
- 写完后登记到
config.mjs侧边栏的「学习日志」分组(texts.journals六语言同步),并在过程记录首页的索引中补一行链接; - 疑问反复出现或想透了一个点,就把它展开成正式文章(见「从日志到专题文章」)。
完整模板(直接复制)
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
ref与reactive的取舍。- 收获:
ref内部就是reactive包一层{ value },所以对象想要解构不失响应必须用toRefs;响应式丢失的本质是「把 Proxy 拆成了普通值」。- 疑问:
reactive对整个对象深代理,为什么官网仍推荐ref为主?——待查编译与心智模型差异。- 明日:跑一个
reactive嵌套赋值是否触发更新的最小用例,验证深层代理行为,写进本站笔记。
写作规范速记
- 命名
YYYY-MM-DD-主题.md,日期用学习当天; - 收获必须是自己的话,能解释给别人听才算数;
- 疑问要写具体(「卡在哪一步」),别写「不懂」;
- 所有过程记录页互相引用使用本站相对链接(
./index、./pitfalls、./retrospective),需要展开的专题链接到对应领域页; - 完成后同步首页索引与
config.mjs侧边栏。
写作规范请参阅过程记录。