Electron 鸿蒙笔记应用实战:让四十条笔记在侧栏里各回各家

分类怎么定、筛选状态放哪、旧数据没有分类字段怎么办——给已有应用补分类功能,最难的不是加字段,是不让新结构把老用户的旧笔记变成"孤儿"。这篇文章用一个跑在鸿蒙 PC 上的 Electron 笔记应用,把分类模型的选择、筛选链路的实现、新旧数据的兼容这三个问题一次讲透。

欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

0. 环境与实测设备

项版本/型号
设备HarmonyOS PC(aarch64),API 26
Electron-OHv40.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(),不走全量数组;
  • 新建笔记的默认分类继承当前筛选视野。
Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐