JavaScript / TypeScript / 知识点
JavaScript 常用开发库速查
可视化与交互
需要补间、弹簧、滚动或手势动画时可使用 motion;适合现代 Web 动效,简单 hover 和过渡优先使用 CSS,避免无必要增加运行时。
Motion 动画
需要补间、弹簧、滚动或手势动画时可使用 motion;适合现代 Web 动效,简单 hover 和过渡优先使用 CSS,避免无必要增加运行时。
安装
npm install motion最小示例
import { animate } from "motion";
animate(
".box",
{ x: 120, opacity: 1 },
{ duration: 0.4 }
);什么时候用
适合需要弹簧、滚动、手势或 JavaScript 驱动补间动画,同时希望保持现代 Web API 风格的项目。
使用边界
简单 hover、颜色和位移动画优先考虑 CSS。动画应尊重 prefers-reduced-motion,并避免让视觉效果影响操作可用性。
列表和看板需要拖拽重排时可使用 sortablejs;适合 DOM 列表排序和跨容器拖拽,框架项目要注意状态与 DOM 顺序同步。
SortableJS 拖拽排序
列表和看板需要拖拽重排时可使用 sortablejs;适合 DOM 列表排序和跨容器拖拽,框架项目要注意状态与 DOM 顺序同步。
安装
npm install sortablejs最小示例
import Sortable from "sortablejs";
Sortable.create(document.querySelector("#items"), {
animation: 150,
onEnd(event) {
console.log(event.oldIndex, event.newIndex);
},
});什么时候用
适合列表、看板和简单跨容器场景中的拖拽排序。
使用边界
在 React、Vue 等声明式框架里,不要只改 DOM 顺序;拖拽完成后应同步更新应用状态,并考虑键盘操作和无障碍支持。
Node.js 服务端开发
需要成熟、生态广泛的 Node.js HTTP 服务框架时可使用 express;适合 API、中间件和传统 Web 服务,工程约束通常需要项目自行建立。
Express Web 服务
需要成熟、生态广泛的 Node.js HTTP 服务框架时可使用 express;适合 API、中间件和传统 Web 服务,工程约束通常需要项目自行建立。
安装
npm install express最小示例
import express from "express";
const app = express();
app.use(express.json());
app.get("/health", (req, res) => {
res.json({ status: "ok" });
});
app.listen(3000);什么时候用
适合需要成熟中间件生态、团队熟悉度高或维护既有 Node.js Web 服务的项目。
使用边界
Express 提供的工程约束较少。大型项目要自行统一错误处理、参数校验、日志、鉴权和目录结构,避免路由层不断膨胀。
需要较高吞吐、Schema 校验和插件化结构的 Node.js API 时可使用 fastify;适合性能敏感服务和结构化后端工程。
Fastify 高性能服务
需要较高吞吐、Schema 校验和插件化结构的 Node.js API 时可使用 fastify;适合性能敏感服务和结构化后端工程。
安装
npm install fastify最小示例
import Fastify from "fastify";
const app = Fastify({ logger: true });
app.get("/health", async () => {
return { status: "ok" };
});
await app.listen({ port: 3000 });什么时候用
适合重视吞吐、Schema、插件边界和结构化后端工程的 Node.js API。
使用边界
不要只根据基准测试决定框架。团队生态、插件兼容和运行环境同样重要;请求 Schema 与业务校验也应区分。
需要面向 Web 标准 API、边缘运行时或轻量 Node.js 服务时可使用 hono;适合多运行时部署和小型高效接口层。
Hono Web 服务
需要面向 Web 标准 API、边缘运行时或轻量 Node.js 服务时可使用 hono;适合多运行时部署和小型高效接口层。
安装
npm install hono @hono/node-server最小示例
import { serve } from "@hono/node-server";
import { Hono } from "hono";
const app = new Hono();
app.get("/health", (c) => c.json({ status: "ok" }));
serve({
fetch: app.fetch,
port: 3000,
});什么时候用
适合希望围绕 Web 标准 Request/Response 编写代码,并在边缘运行时、Bun、Deno 或 Node.js 之间保持较高可移植性的服务。
使用边界
Node.js 下通常需要对应适配器,例如 @hono/node-server。部署到不同运行时时,要检查该平台对 Node API、WebSocket 和文件系统的支持差异。
Node.js 服务需要低开销结构化日志时可使用 pino;适合生产日志采集与 JSON 输出,应统一字段、脱敏和请求追踪规范。
Pino 日志
Node.js 服务需要低开销结构化日志时可使用 pino;适合生产日志采集与 JSON 输出,应统一字段、脱敏和请求追踪规范。
安装
npm install pino最小示例
import pino from "pino";
const logger = pino();
logger.info(
{ requestId: "req-1001", userId: 42 },
"request completed"
);什么时候用
适合 Node.js 服务输出低开销、便于日志平台采集的结构化 JSON 日志。
使用边界
日志字段比漂亮输出更重要。生产环境应统一 requestId、错误栈、脱敏、等级和采集规范,避免记录令牌、密码或敏感个人数据。
Express 应用需要解析 multipart/form-data 文件上传时可使用 multer;必须同时限制文件大小、类型和保存位置,不能只依赖扩展名判断。
Multer 文件上传
Express 应用需要解析 multipart/form-data 文件上传时可使用 multer;必须同时限制文件大小、类型和保存位置,不能只依赖扩展名判断。
安装
npm install multer最小示例
import multer from "multer";
const upload = multer({
dest: "uploads/",
limits: { fileSize: 5 * 1024 * 1024 },
});
app.post("/upload", upload.single("file"), (req, res) => {
res.json({ filename: req.file.filename });
});什么时候用
适合 Express 风格服务解析 multipart/form-data 并接收单文件或多文件上传。
使用边界
必须限制文件大小、数量和保存目录,并校验真实内容类型。不要只根据扩展名或客户端传来的 MIME 类型判断文件安全性。
Node.js 中需要基于 Redis 实现后台任务、延迟任务、重试和 Worker 时可使用 bullmq;适合耗时任务异步化和任务队列。
BullMQ 后台任务
Node.js 中需要基于 Redis 实现后台任务、延迟任务、重试和 Worker 时可使用 bullmq;适合耗时任务异步化和任务队列。
安装
npm install bullmq最小示例
import { Queue, Worker } from "bullmq";
const connection = { host: "127.0.0.1", port: 6379 };
const queue = new Queue("email", { connection });
await queue.add("welcome", { userId: 42 });
new Worker(
"email",
async (job) => {
console.log("send email to", job.data.userId);
},
{ connection }
);什么时候用
适合把发邮件、生成报表、图片处理等耗时任务从 HTTP 请求链路移到 Redis 后台队列。
使用边界
队列不自动保证业务幂等。Worker 重试、重复消费、失败任务、超时和 Redis 可用性都需要设计,并避免把超大二进制内容直接塞进 Job 数据。
单实例 Node.js 服务需要按 Cron 表达式执行周期任务时可使用 node-cron;多实例部署必须额外处理重复执行和分布式协调。
node-cron 定时任务
单实例 Node.js 服务需要按 Cron 表达式执行周期任务时可使用 node-cron;多实例部署必须额外处理重复执行和分布式协调。
安装
npm install node-cron最小示例
import cron from "node-cron";
cron.schedule("0 * * * *", () => {
console.log("run every hour");
});什么时候用
适合单实例工具或明确只有一个调度节点的 Node.js 应用执行周期任务。
使用边界
应用横向扩容后,每个实例都可能执行同一任务。涉及唯一执行、补偿和持久调度时,应引入分布式协调或专门任务系统。
需要为 Node.js 脚本构建参数、选项和子命令时可使用 commander;适合内部工具和正式 CLI,复杂交互可再组合其他终端库。
Commander 命令行工具
需要为 Node.js 脚本构建参数、选项和子命令时可使用 commander;适合内部工具和正式 CLI,复杂交互可再组合其他终端库。
安装
npm install commander最小示例
import { Command } from "commander";
const program = new Command();
program
.name("hello")
.option("-n, --name <name>", "name", "world")
.parse();
console.log(`Hello, ${program.opts().name}`);什么时候用
适合 Node.js 脚本需要标准选项、参数、子命令和帮助信息,并准备长期维护为正式 CLI 的场景。
使用边界
Commander 主要负责命令解析。复杂交互式问答、进度条和终端 UI 可以按需组合专门库,不要把所有交互逻辑堆进参数定义。
数据库与缓存
TypeScript 或 Node.js 项目需要类型安全的数据访问、Schema 管理和迁移能力时可使用 Prisma;适合常规业务系统和关系数据库开发。
Prisma ORM
TypeScript 或 Node.js 项目需要类型安全的数据访问、Schema 管理和迁移能力时可使用 Prisma;适合常规业务系统和关系数据库开发。
安装
npm install @prisma/client
npm install -D prisma最小示例
// 生成路径取决于项目的 Prisma generator 配置
import { PrismaClient } from "./generated/client";
const prisma = new PrismaClient();
const users = await prisma.user.findMany();
console.log(users);什么时候用
适合希望通过 Schema、生成客户端和类型安全查询构建 Node.js/TypeScript 数据访问层的业务系统。
使用边界
Prisma 的生成器、CLI 和包组织会随 major version 演进,应锁定项目版本并按对应版本文档配置。复杂 SQL、数据库特有能力和迁移策略仍需理解底层数据库。
希望 ORM 更贴近 SQL、保留较强类型推导并保持较轻抽象时可使用 drizzle-orm;数据库驱动需根据实际数据库另外选择。
Drizzle ORM
希望 ORM 更贴近 SQL、保留较强类型推导并保持较轻抽象时可使用 drizzle-orm;数据库驱动需根据实际数据库另外选择。
安装
npm install drizzle-orm pg最小示例
import { drizzle } from "drizzle-orm/node-postgres";
import { sql } from "drizzle-orm";
import pg from "pg";
const pool = new pg.Pool({
connectionString: process.env.DATABASE_URL,
});
const db = drizzle(pool);
const result = await db.execute(sql`select 1 as value`);
console.log(result.rows);什么时候用
适合希望类型安全但仍保持明显 SQL 思维、控制查询和数据库能力的 TypeScript 后端。
使用边界
Drizzle 需要根据数据库选择对应驱动。ORM 减少样板代码,不代表可以忽略索引、事务、锁、执行计划和数据库本身的限制。
Node.js 直接访问 PostgreSQL 时常用 pg;适合参数化 SQL、连接池和底层数据库访问,也常作为上层 ORM 的驱动基础。
pg PostgreSQL 客户端
Node.js 直接访问 PostgreSQL 时常用 pg;适合参数化 SQL、连接池和底层数据库访问,也常作为上层 ORM 的驱动基础。
安装
npm install pg最小示例
import pg from "pg";
const { Pool } = pg;
const pool = new Pool({
connectionString: process.env.DATABASE_URL,
});
const result = await pool.query(
"SELECT $1::int AS value",
[42]
);
console.log(result.rows[0]);什么时候用
适合需要直接写 PostgreSQL SQL、使用连接池,或为上层查询层提供底层驱动的 Node.js 项目。
使用边界
动态值使用参数绑定,不要字符串拼接 SQL。连接池大小、事务边界、查询超时和连接释放策略要根据生产负载配置。
Node.js 访问 MySQL 或兼容数据库时可使用 mysql2;支持 Promise API、预处理语句和连接池,适合直接 SQL 与 ORM 驱动。
mysql2 MySQL 客户端
Node.js 访问 MySQL 或兼容数据库时可使用 mysql2;支持 Promise API、预处理语句和连接池,适合直接 SQL 与 ORM 驱动。
安装
npm install mysql2最小示例
import mysql from "mysql2/promise";
const pool = mysql.createPool({
host: "127.0.0.1",
user: "app",
password: "secret",
database: "demo",
});
const [rows] = await pool.execute(
"SELECT ? AS value",
[42]
);
console.log(rows);什么时候用
适合 Node.js 直接访问 MySQL、使用 Promise API、连接池和预处理语句的项目。
使用边界
生产密码不要写在源码中。SQL 使用占位符,连接池要设置合理上限,并区分连接级事务与普通池查询。
需要在 Node.js 中操作 Redis、Cluster、Sentinel 或 Pub/Sub 时可使用 ioredis;适合缓存、消息和分布式协调等服务端场景。
ioredis Redis 客户端
需要在 Node.js 中操作 Redis、Cluster、Sentinel 或 Pub/Sub 时可使用 ioredis;适合缓存、消息和分布式协调等服务端场景。
安装
npm install ioredis最小示例
import Redis from "ioredis";
const redis = new Redis("redis://127.0.0.1:6379");
await redis.set("demo:key", "value", "EX", 60);
console.log(await redis.get("demo:key"));
redis.disconnect();什么时候用
适合 Node.js 中需要 Redis、Cluster、Sentinel、Pipeline 或 Pub/Sub 能力的缓存和基础设施场景。
使用边界
Redis 单条命令原子不代表多步业务自动安全。分布式锁、库存扣减和状态迁移仍需考虑 Lua、事务、过期和故障切换。
测试与浏览器自动化
Vite 或现代 ESM/TypeScript 项目需要快速单元测试时可使用 vitest;适合前端和通用模块测试,并能与 Vite 配置良好协作。
Vitest 单元测试
Vite 或现代 ESM/TypeScript 项目需要快速单元测试时可使用 vitest;适合前端和通用模块测试,并能与 Vite 配置良好协作。
安装
npm install -D vitest最小示例
import { expect, test } from "vitest";
test("adds two numbers", () => {
expect(2 + 3).toBe(5);
});什么时候用
适合 Vite、ESM 和现代 TypeScript 项目的单元测试与模块测试,启动速度和开发体验通常很好。
使用边界
单元测试不等于浏览器真实流程验证。涉及页面交互、网络和跨浏览器行为时,应搭配 Playwright 等 E2E 工具。
已有成熟 Jest 生态、需要广泛 Mock 与测试工具支持时可使用 jest;适合存量项目和通用 JavaScript 测试,新项目可同时评估 Vitest。
Jest 单元测试
已有成熟 Jest 生态、需要广泛 Mock 与测试工具支持时可使用 jest;适合存量项目和通用 JavaScript 测试,新项目可同时评估 Vitest。
安装
npm install -D jest最小示例
test("adds two numbers", () => {
expect(2 + 3).toBe(5);
});什么时候用
适合已有 Jest 测试资产、依赖其 Mock 生态或需要维护成熟存量项目的团队。
使用边界
ESM、TypeScript 和现代构建链的配置方式与老项目可能不同。新项目不必因为知名度默认选择 Jest,应结合现有工具链评估。
需要跨 Chromium、Firefox 和 WebKit 验证真实浏览器流程时可使用 playwright;适合 E2E、页面自动化和回归测试。
Playwright 端到端测试
需要跨 Chromium、Firefox 和 WebKit 验证真实浏览器流程时可使用 playwright;适合 E2E、页面自动化和回归测试。
安装
npm install -D @playwright/test
npx playwright install最小示例
import { test, expect } from "@playwright/test";
test("home page has title", async ({ page }) => {
await page.goto("https://example.com");
await expect(page).toHaveTitle(/Example/);
});什么时候用
适合验证登录、下单、表单等真实浏览器用户路径,并需要 Chromium、Firefox、WebKit 跨浏览器覆盖的项目。
使用边界
E2E 成本高于单元测试,应聚焦关键流程而不是覆盖所有细枝末节。测试数据、等待条件和环境隔离会直接影响稳定性。
构建与代码质量
现代前端项目需要快速开发服务器、模块热更新和生产构建时可使用 vite;适合多种前端框架,也可作为通用 Web 构建基础。
Vite 前端构建
现代前端项目需要快速开发服务器、模块热更新和生产构建时可使用 vite;适合多种前端框架,也可作为通用 Web 构建基础。
安装
npm install -D vite最小示例
{
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
}
}什么时候用
适合现代 Web 项目获得快速开发服务器、HMR 和生产构建,也常作为 React、Vue 等框架项目的基础工具。
使用边界
Vite 是构建工具,不替代框架和部署平台。SSR、老浏览器兼容、特殊 Rollup 插件或大型单仓库仍需额外配置。
需要发现 JavaScript 或 TypeScript 潜在错误并统一代码规则时可使用 eslint;适合本地开发与 CI,规则和插件应在项目中固定。
ESLint 代码检查
需要发现 JavaScript 或 TypeScript 潜在错误并统一代码规则时可使用 eslint;适合本地开发与 CI,规则和插件应在项目中固定。
安装
npm install -D eslint最小示例
npx eslint .什么时候用
适合在本地和 CI 中发现潜在错误、危险模式和团队约定问题,覆盖 JavaScript 与 TypeScript 工程。
使用边界
Lint 规则越多不等于质量越高。应围绕真实缺陷和团队共识配置规则,并固定版本,避免编辑器与 CI 结果不一致。