Electron 鸿蒙笔记应用实战:让四十条笔记在侧栏里各回各家
Electron 鸿蒙笔记应用实战:让四十条笔记在侧栏里各回各家
分类怎么定、筛选状态放哪、旧数据没有分类字段怎么办——给已有应用补分类功能,最难的不是加字段,是不让新结构把老用户的旧笔记变成"孤儿"。这篇文章用一个跑在鸿蒙 PC 上的 Electron 笔记应用,把分类模型的选择、筛选链路的实现、新旧数据的兼容这三个问题一次讲透。
欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
0. 环境与实测设备
| 项 | 版本/型号 |
|---|---|
| 设备 | HarmonyOS PC(aarch64),API 26 |
| Electron-OH | v40.0.1(预编译 libelectron.so) |
| 数据存储 | userData/notes.json(全量数组,hmdfs 沙箱) |
| 分类实现范围 | 渲染层:筛选条 + 编辑器下拉 + 列表展示 |
| 存储格式变化 | 笔记对象新增可选字段 category,无迁移脚本 |
最后一行是这篇的核心决策,先亮出来:分类字段的存储格式是"可选字段",不是"新 schema"。旧笔记没有这个字段也能正常工作,不跑迁移、不升级版本号。这个决定怎么来的,第 3 节展开。
1. 列表只有一条长队——这个问题是怎么找上我的
删除功能上线(给自己用)之后,我开始真正高频地用这个笔记应用。一周之后,列表里躺着二十六条笔记:工作的会议记录、生活的采购清单、半夜冒出来的灵感、还有一些当时觉得重要现在完全想不起来的碎片。
侧栏是一条从上到下的长队,最新修改的排最前面。找东西靠两样:滚动,和回忆"大概是哪天写的"。有一天我要找一份两周前的会议记录,翻列表翻了两分钟——内容明明就在那里,就是找不到。
我一开始也以为这只是"笔记多了"的问题,忍一忍或者加个搜索框就行。后来才反应过来:我缺的不是搜索,是结构。搜索回答的是"我知道要找什么";我当时的困境是"我记得写过类似的,但不知道在哪"——这是组织问题,不是检索问题。二十六条笔记尚且如此,一百条之后长队列就是垃圾场。
搜索和分类不冲突,但解决的是两类痛。这个应用当前阶段的答案很明确:先分类。
所以这个题目的边界很清楚:给每条笔记一个分类字段,侧栏加一排筛选胶囊,编辑器给一个切换入口,旧数据无字段时归入"未分类",全程不写迁移脚本。
拆下来是三件事:
- 定分类模型:固定枚举还是用户自建,这个决定牵动后面所有 UI;
- 筛选状态放哪:谁持有"当前正在看哪个分类",新建笔记继承谁;
- 旧数据兼容:没有
category字段的笔记怎么显示、怎么统计。
下面是干完之后的完整记录,包括我踩的每一个坑。
2. 按老规矩,先给效果再讲原理

图1 侧栏筛选条:胶囊排布,选中项渐变高亮
侧栏顶部的筛选条是五个胶囊按钮:全部 + 四个分类。选中的那个底色变成蓝紫渐变,和"新建"按钮同一套视觉语言——筛选是操作,不是标签,所以它长得像按钮而不像文字。
这里每一处都不是装饰:
- 胶囊形(
border-radius: 999px):筛选词都很短(两个字),胶囊形在视觉上把"这是一组互斥选项"表达得最紧凑; - 选中态用渐变:未选中的胶囊是深色底灰字,选中后是蓝紫渐变白字,对比足够强,扫一眼就知道自己在哪个视野里;
- 排布在列表上方、不随列表滚动:筛选条是导航,导航不能被内容卷走。

图2 编辑器入口:当前笔记的分类在下拉框里直接切换
编辑器左上角的下拉框负责"改归属":打开某条笔记,下拉框显示它当前的分类,切换即生效。列表条目的时间一行随之变成 工作 · 2026-11-17 21:44 这样的组合——分类和时间排在一条线上,扫列表时两个维度同时可读。
两个入口的分工是刻意设计的:筛选条改变"我在看什么",下拉框改变"这条是什么"。一个是视野,一个是数据。混在一起做(比如点击列表条目上的分类标签直接筛选)会让两个心智模型打架——用户分不清哪一下是"看",哪一下是"改"。
3. 原理:分类是字段还是实体
分类功能动工前要想清楚的第一个问题不是 UI,是模型:分类到底是什么?
两条路线摆在一起比:
| 维度 | 路线 A:固定枚举 | 路线 B:用户自建 |
|---|---|---|
| 数据结构 | 笔记加一个 category 字符串 | 新增分类实体表,笔记存分类 id |
| UI 成本 | 筛选条写死几个胶囊 | 需要分类管理页、增删改名、空分类处理 |
| 数据风险 | 低——字段可选,无外键一致性 | 中——删除分类时笔记的归属要定义 |
| 适合规模 | 个人工具、几十到几百条 | 多用户、长周期、分类会生长 |
分类的复杂度不在"存一个字符串",在"分类自己成为数据之后的一切连带责任"。 用户自建分类意味着:分类可以被改名(所有引用它的笔记要不要跟着变?)、可以被删除(分类下的笔记去哪?)、可以新建(新建入口放哪、空分类显不显示?)。这三个连带问题每一个都要 UI 和数据两侧同时回答。
我的答案是路线 A:个人工具,四类够用。未分类 / 工作 / 生活 / 灵感,写死在渲染层顶部的一个数组里:
// renderer.js - 顶部常量
const CATEGORIES = ['未分类', '工作', '生活', '灵感'];
let activeCategory = '全部';
"全部"不在 CATEGORIES 里——它不是一个分类,是一个筛选视图。这个区分在后文的可见列表逻辑里有直接用途。
这是模型决策,不是偷懒。 路线 B 不是"更高级",是"更贵":它的每一分钱都花在多用户场景的必要性上,而单用户个人工具花不起也没必要花。哪天分类真不够用了,从 A 升 B 的成本是清晰的(枚举值变实体 id,一次数据迁移),现在提前预付反而会被三个连带问题拖住主线。
4. 把代码讲透
4.1 筛选条:一个状态驱动两组渲染
// renderer.js - renderCatFilter()(节选)
function renderCatFilter() {
catFilterEl.textContent = '';
['全部', ...CATEGORIES].forEach(c => {
const chip = document.createElement('button');
chip.className = 'cat-chip' + (c === activeCategory ? ' active' : '');
chip.textContent = c;
chip.addEventListener('click', () => {
activeCategory = c;
renderCatFilter(); // 刷新胶囊高亮
renderList(); // 刷新列表内容
});
catFilterEl.appendChild(chip);
});
}

整个筛选功能只有一个状态:顶层变量 activeCategory。点胶囊改它,然后刷新两组 UI——胶囊自己的高亮,和下面的列表。没有第二个状态,没有派生状态,没有缓存。
这么写的原因是吃过亏的(坑三详述):筛选状态一旦和"列表当前展示的内容"分成两个真相源,两者就会以各种姿态失步——筛选了"工作",列表还是全量;改了分类,列表还在旧筛选下。单一状态源 + 全量重渲染,在几十条笔记的规模下比增量更新更不容易错。renderList() 每次清空重建,看起来"浪费",实际是这个规模下最稳的写法。
4.2 可见列表:筛选逻辑只允许存在一处
// renderer.js - visibleNotes()
function visibleNotes() {
return activeCategory === '全部'
? notes
: notes.filter(n => (n.category || '未分类') === activeCategory);
}
这个函数七行,是整个分类功能的心脏。两个细节值得单独说。
第一,(n.category || '未分类') 这半句是旧数据兼容的全部。 旧笔记对象里没有 category 字段,读到的是 undefined,|| 把它兜成"未分类"。不迁移、不补字段,兼容逻辑写在读取侧而不是写入侧——写入侧做兼容(加载时给每条补字段)也能工作,但那意味着加载函数有了副作用,而副作用藏在"读"里是最难排查的一类 bug。读取侧兜底,原始数据永远保持原样。
第二,"全部"在这里是硬编码的分支,不在数组里遍历。 因为"全部"的语义是"不做筛选",塞进同一套 filter 逻辑里只会让它变得绕。前面说它不是分类是视图,在这里兑现。
4.3 切换归属:下拉框是唯一的写入入口
// renderer.js - 分类下拉(节选)
categoryEl.addEventListener('change', () => {
const n = currentNote();
if (n) {
n.category = categoryEl.value;
n.updatedAt = Date.now();
updateStatus(false);
scheduleSave(); // 走已有的防抖保存
renderList(); // 立刻反映在列表上
}
});

改分类的链路完全复用编辑的既有基建:改字段、刷新状态、走 400ms 防抖保存、重渲染列表。没有为"分类变更"新开一条保存通道——它本质就是一次数据编辑,全量保存模型天然覆盖。
有一个时序细节:scheduleSave() 是防抖的,意味着改完分类的 400ms 内数据还没落盘。这期间如果用户立刻切换到别的笔记,selectNote() 开头的 flushSave() 会先把这次分类变更冲掉再切——防抖和切笔记的交接处,正是当初做防抖时预留的兜底点,分类功能白捡了这层保护。这就是"新功能长在旧架构预留的缝里"和"新功能自己另起炉灶"的区别。
n.updatedAt = Date.now() 这行是主观决策:改分类算不算"修改"?我的答案是算——分类变了,它在"最近修改"排序里的位置就应该变,用户的直觉是"我刚动过它"。如果你的产品语义认为改分类不算修改,删掉这行即可,模型本身不受影响。
4.4 新建继承:筛选视野决定默认归属
// renderer.js - newNote()(节选)
const n = {
id: Date.now().toString(36) + Math.random().toString(36).slice(2, 6),
title: '',
content: '',
category: activeCategory === '全部' ? '未分类' : activeCategory,
updatedAt: Date.now()
};
在"工作"筛选下点"+",新笔记自动归入"工作";在"全部"视野下新建,归入"未分类"。
这里有一个容易做反的设计:让新建永远归"未分类",用户自己再改。试过之后我改成了继承——因为用户的操作流是"我要记一件工作上的事"→ 筛到"工作" → 新建,筛选动作本身已经表达了归属意图,新建再归"未分类"等于无视了用户刚做的那次表达。默认值应该顺着用户刚走过的路,而不是退回起点。
5. 我踩过的坑(每一条都有真实出处)
坑一:列表和筛选状态失步。 第一版我把"当前筛选"存在了筛选条组件自己的闭包里,列表渲染函数每次去读它。现象是偶发的:筛到"工作",列表偶尔还是全量——因为两条渲染路径读状态的时机不同步。后来把 activeCategory 提到模块顶层,筛选和列表都只在它变更后重渲染,失步消失。筛选状态是全局视野,放在任何局部作用域里都会变成两个真相源。
坑二:删除功能接上后,跳错了笔记。 这是分类和删除两个功能交界处的事故:删除当前笔记后,跳转目标是 notes[0]——全量列表的第一条,可能属于任何分类。用户正筛着"生活",删完一条,编辑器却跳到了"工作"的某条上,筛选胶囊还停在"生活"。修正为 visibleNotes()[0],跳转尊重当前视野。两个功能交界处的事故,比单功能内部的事故难查一倍,因为两侧的代码"都没错"。
坑三:缓存了筛选结果。 中间版本我缓存过 filteredNotes,在笔记数据变更时才重算。省的那点计算量在几十条规模下完全无感,引入的失步 bug 却实打实修了半小时。删掉缓存,每次 renderList() 现算。在渲染层做数据缓存,先问问自己规模到了没有。
坑四:undefined 的分类显示成了"undefined"。 旧笔记改分类前,列表条目的元信息行显示 undefined · 2026-11-17。原因是我先在展示层拼了 n.category + ' · ',没做兜底。后来统一走 visibleNotes() 和展示处共用的 (n.category || '未分类') 表达式——兼容表达式只允许写一份,写两份必然有一天漏改一处。兼容逻辑是全应用最需要单一事实源的地方。
坑五:筛选条被长列表卷走。 早期筛选条放在 #note-list 内部,列表一滚,筛选条跟着上移消失。原因是它被当成了列表内容的一部分。挪到列表外层、固定在侧栏头部之后才稳定。导航元素和内容元素在 DOM 结构上就必须分开,靠 CSS 补救(sticky)是次优解。
6. 现在怎么用:边界与收尾
分类功能总共四段代码:常量数组、筛选条渲染、可见列表、下拉监听,加起来不到六十行。接入到别的 Electron 项目,前提只有两个:笔记对象是普通 JSON 可序列化结构(category 字段直接挂上去)、列表是全量重渲染模式(筛选只需要一个 filter)。
硬限制列一下,免得读者踩到同一堵墙:
- 固定枚举和用户自建是模型分叉点,先想清楚分类会不会"生长",再决定要不要为它建实体;
- 旧数据兼容写在读取侧(
|| '未分类'),不要在加载时改写原始数据; - 兼容表达式全应用只写一份;
- 筛选状态必须是单一状态源,任何派生缓存都会失步;
- 删除、跳转等一切"以列表为参照"的操作,走可见列表
visibleNotes(),不走全量数组; - 新建笔记的默认分类继承当前筛选视野。
更多推荐



所有评论(0)