老实说，

使用者痛点：写代码不写测试。就像走钢丝不挂安全绳——早晚要出事。ChatCrystal 作为一个涉及文件解析、数据库操作、向量索引、LLM 调用的全栈项目，缺少可靠的测试会导致每次发版都有翻车风险。说起来，

这篇文章以 ChatCrystal 的真实测试代码为例。从测试金字塔讲起，手把手带你写纯函数单元测试、数据库集成测试、API 路由测试，再到 CI 自动化。所有代码都可以在 里找到。

测试金字塔

测试金字塔是一个经典模型，从底到顶分三层：

/ E2E \ 少量，慢，贵
/─────────\
/ Integration \ 适量。中速
/───────────────\
/ Unit Tests \ 大量，快，便宜
/───────────────────\

• 单元测试测单个函数，不依赖外部程序。跑得快、写得快、维护成本低。应该占测试总量的绝大多数。
• 集成测试测多个模块协作，涉及数据库、文件程序、HTTP 请求。 跑得慢一些，但能发现单元测试覆盖不到的接口问题。
• 端到端测试模拟真实使用者操作。ChatCrystal 目前以单元测试和集成测试为主，E2E 留给 Electron 打包后的手动验证。话说回来，

ChatCrystal 的测试命令很简单：

npm test # 等价于 tsx --test src/**/*.test.ts

使用的是 Node.js 内置的 node:test 模块。不需要装 Jest 或 Vitest。零依赖，开箱即用，

至于选型，为什么用 node:test

ChatCrystal 没有选 Jest，也没有选 Vitest。而是用 Node.js 自带的 node:test + node:assert/strict。从原因如下来看，

1. 零依赖不需要在 devDependencies 里加任何额外框架。
2. 原生 ESM 支持项目全量使用 ESM（"type": "module")，node:test 天然兼容。
3. tsx 集成tsx --test 可直接运行 TypeScript 测试文件，无需额外编译步骤。
4. 够用即好提供了 test,describe。b

efore,