JavaScript / TypeScript / 知识点
JavaScript 常用开发库速查
HTTP 与实时通信
适合浏览器与 Node.js 中的常规 HTTP 调用,支持拦截器、请求配置和响应转换;已有统一请求层或需要兼容成熟生态时优先考虑。
Axios HTTP 请求
适合浏览器与 Node.js 中的常规 HTTP 调用,支持拦截器、请求配置和响应转换;已有统一请求层或需要兼容成熟生态时优先考虑。
安装
npm install axios最小示例
import axios from "axios";
const response = await axios.get("https://api.example.com/users", {
timeout: 5000,
});
console.log(response.data);什么时候用
适合浏览器和 Node.js 中有统一请求封装需求的项目,尤其是需要拦截器、统一超时、认证头和错误转换时。
使用边界
不要因为项目已有原生 fetch 就机械替换。请求层应统一处理超时、取消、重试和错误映射;对非幂等写请求启用自动重试前要先确认业务语义。
基于 Fetch API 提供更轻量的请求封装,内置重试、超时和 JSON 便捷处理;适合现代浏览器项目和偏好 Fetch 风格的代码库。
Ky 轻量 HTTP 请求
基于 Fetch API 提供更轻量的请求封装,内置重试、超时和 JSON 便捷处理;适合现代浏览器项目和偏好 Fetch 风格的代码库。
安装
npm install ky最小示例
import ky from "ky";
const users = await ky
.get("https://api.example.com/users", { timeout: 5000 })
.json();
console.log(users);什么时候用
适合现代浏览器或支持 Fetch API 的运行时,想保留 Fetch 风格又希望获得超时、重试和 JSON 便捷处理时。
使用边界
Ky 建立在 Fetch API 之上,不是 Axios 的完全替代品。团队已有成熟 Axios 拦截器体系时,迁移收益可能有限。
需要事件式双向通信、自动重连和房间能力时可使用 Socket.IO;它并非原生 WebSocket 协议,客户端与服务端通常需要配套使用。
Socket.IO 实时通信
需要事件式双向通信、自动重连和房间能力时可使用 Socket.IO;它并非原生 WebSocket 协议,客户端与服务端通常需要配套使用。
安装
npm install socket.io socket.io-client最小示例
// server.js
import { Server } from "socket.io";
const io = new Server(3000, {
cors: { origin: "http://localhost:5173" },
});
io.on("connection", (socket) => {
socket.on("chat", (message) => {
io.emit("chat", message);
});
});什么时候用
适合聊天室、在线状态、协作通知等需要事件模型、自动重连、房间和广播能力的实时应用。
使用边界
Socket.IO 有自己的协议层,并不等于原生 WebSocket。若必须和只支持标准 WebSocket 的系统互通,应选择 ws 或运行时原生 WebSocket API。
Node.js 中需要直接实现标准 WebSocket 客户端或服务端时可使用 ws;适合协议较简单、希望减少额外抽象的实时通信场景。
ws WebSocket 服务
Node.js 中需要直接实现标准 WebSocket 客户端或服务端时可使用 ws;适合协议较简单、希望减少额外抽象的实时通信场景。
安装
npm install ws最小示例
import { WebSocketServer } from "ws";
const wss = new WebSocketServer({ port: 8080 });
wss.on("connection", (socket) => {
socket.on("message", (data) => {
socket.send(`echo: ${data}`);
});
});什么时候用
适合 Node.js 中需要直接使用标准 WebSocket 协议、控制握手与连接生命周期的客户端或服务端。
使用边界
ws 不提供房间、事件命名空间等 Socket.IO 高层能力。生产环境还要自行处理鉴权、心跳、断线、限流和连接资源控制。
通用工具与数据处理
数组、对象、集合和函数处理需要成熟工具函数时可使用 lodash-es;现代项目优先按需导入,并避免替代已经足够清晰的原生语法。
Lodash 工具函数
数组、对象、集合和函数处理需要成熟工具函数时可使用 lodash-es;现代项目优先按需导入,并避免替代已经足够清晰的原生语法。
安装
npm install lodash-es最小示例
import { groupBy } from "lodash-es";
const rows = [
{ team: "A", name: "Ada" },
{ team: "B", name: "Lin" },
{ team: "A", name: "Sam" },
];
console.log(groupBy(rows, "team"));什么时候用
适合对象、数组、集合转换中确实存在复杂组合操作,且成熟工具函数能明显提高可读性的场景。
使用边界
现代 JavaScript 已内置很多数组和对象能力。简单的 map、filter、Object.entries 不必为了统一风格全部改成 Lodash。
需要生成短小、随机且 URL 友好的标识符时可使用 nanoid;适合前端临时 ID、公开标识等场景,不替代数据库业务唯一性约束。
Nano ID 短 ID
需要生成短小、随机且 URL 友好的标识符时可使用 nanoid;适合前端临时 ID、公开标识等场景,不替代数据库业务唯一性约束。
安装
npm install nanoid最小示例
import { nanoid } from "nanoid";
const id = nanoid();
console.log(id);什么时候用
适合前端临时实体、公开链接标识、客户端生成 ID 等需要短小随机标识符的场景。
使用边界
随机 ID 只能降低碰撞概率,不能替代数据库唯一约束。需要固定标准格式或跨系统协议约定时优先考虑 UUID。
需要生成标准 UUID 时可使用 uuid;适合跨系统标识、请求追踪和实体 ID,是否作为数据库主键仍需结合索引与存储策略判断。
UUID 标识符
需要生成标准 UUID 时可使用 uuid;适合跨系统标识、请求追踪和实体 ID,是否作为数据库主键仍需结合索引与存储策略判断。
安装
npm install uuid最小示例
import { v4 as uuidv4 } from "uuid";
const requestId = uuidv4();
console.log(requestId);什么时候用
适合请求追踪、跨服务实体标识和需要标准 UUID 格式的系统。
使用边界
UUID 是否适合作为数据库聚簇主键要结合数据库、索引和写入模式判断;不要只因为“全局唯一”就默认作为所有表的主键。
处理嵌套对象或状态时可用 immer 以可变写法生成不可变结果;适合复杂状态更新,简单对象复制不必额外引入依赖。
Immer 不可变更新
处理嵌套对象或状态时可用 immer 以可变写法生成不可变结果;适合复杂状态更新,简单对象复制不必额外引入依赖。
安装
npm install immer最小示例
import { produce } from "immer";
const state = {
user: { name: "Ada", enabled: false },
};
const nextState = produce(state, (draft) => {
draft.user.enabled = true;
});
console.log(nextState.user.enabled);什么时候用
适合 Redux、复杂表单或深层嵌套状态中,希望以直观写法完成不可变更新的场景。
使用边界
简单一层对象用展开语法通常更清晰。不要把 Immer 当作所有对象修改的默认依赖,否则会增加概念和运行时成本。
金额、汇率或高精度小数计算可使用 decimal.js,避免 JavaScript 浮点误差影响结果;涉及财务规则时仍应明确舍入和精度策略。
Decimal 精确小数
金额、汇率或高精度小数计算可使用 decimal.js,避免 JavaScript 浮点误差影响结果;涉及财务规则时仍应明确舍入和精度策略。
安装
npm install decimal.js最小示例
import Decimal from "decimal.js";
const total = new Decimal("0.1").plus("0.2");
console.log(total.toString()); // 0.3什么时候用
适合金额、税率、汇率和高精度小数计算,避免二进制浮点误差直接进入业务结果。
使用边界
精确小数库不会替你决定财务规则。币种最小单位、精度位数和舍入模式仍要在业务层明确并统一。
日期、校验与安全
需要轻量日期解析、格式化和时间计算时可使用 dayjs;API 接近 Moment.js,功能通过插件扩展,复杂时区需求应额外验证。
Day.js 日期处理
需要轻量日期解析、格式化和时间计算时可使用 dayjs;API 接近 Moment.js,功能通过插件扩展,复杂时区需求应额外验证。
安装
npm install dayjs最小示例
import dayjs from "dayjs";
const deadline = dayjs("2026-10-01")
.add(7, "day")
.format("YYYY-MM-DD");
console.log(deadline);什么时候用
适合希望用链式 API 完成常规日期解析、格式化、加减和比较的项目。
使用边界
时区、ISO 周、相对时间等能力通常依赖插件。日期字符串解析必须明确格式和时区,避免依赖浏览器的模糊解析行为。
偏好函数式、按需导入的日期处理方式时可使用 date-fns;适合格式化、区间和日期运算,能减少全局可变对象带来的理解成本。
date-fns 日期函数
偏好函数式、按需导入的日期处理方式时可使用 date-fns;适合格式化、区间和日期运算,能减少全局可变对象带来的理解成本。
安装
npm install date-fns最小示例
import { addDays, format } from "date-fns";
const result = addDays(new Date(2026, 8, 28), 7);
console.log(format(result, "yyyy-MM-dd"));什么时候用
适合偏好函数式、按需组合日期操作的代码库,尤其是希望减少链式对象状态的项目。
使用边界
JavaScript Date 本身仍携带本地时区语义。跨时区业务要明确 UTC、用户时区和存储格式,不要只靠格式化函数解决。
TypeScript 项目需要运行时数据校验并同步获得静态类型推导时可使用 zod;适合接口响应、表单数据和配置边界校验。
Zod 数据校验
TypeScript 项目需要运行时数据校验并同步获得静态类型推导时可使用 zod;适合接口响应、表单数据和配置边界校验。
安装
npm install zod最小示例
import { z } from "zod";
const User = z.object({
id: z.number().int().positive(),
name: z.string().min(1),
});
const user = User.parse({ id: 1, name: "Ada" });
console.log(user);什么时候用
适合 TypeScript 项目在运行时校验接口响应、表单输入、环境变量和消息数据,并从 Schema 推导类型。
使用边界
类型检查只存在于编译期,Zod 校验发生在运行时。结构通过校验不代表业务规则一定成立,权限和业务状态仍需单独判断。
已有 JSON Schema 或需要标准化跨语言数据契约时可使用 ajv;适合配置、消息和接口结构校验,不以 TypeScript 类型推导为中心。
Ajv JSON Schema 校验
已有 JSON Schema 或需要标准化跨语言数据契约时可使用 ajv;适合配置、消息和接口结构校验,不以 TypeScript 类型推导为中心。
安装
npm install ajv最小示例
import Ajv from "ajv";
const ajv = new Ajv();
const schema = {
type: "object",
properties: {
name: { type: "string" },
},
required: ["name"],
additionalProperties: false,
};
const validate = ajv.compile(schema);
console.log(validate({ name: "Ada" }));什么时候用
适合已有 JSON Schema、需要跨语言共享数据契约或需要标准 Schema 校验的 API、配置和消息系统。
使用边界
Ajv 的优势是标准化契约,不是 TypeScript 类型体验。Schema 版本、格式扩展和错误展示策略应在项目中统一。
邮箱、URL、IP、手机号等字符串格式需要成熟校验函数时可使用 validator;格式合法不代表业务真实有效,仍需服务端规则确认。
validator 字符串校验
邮箱、URL、IP、手机号等字符串格式需要成熟校验函数时可使用 validator;格式合法不代表业务真实有效,仍需服务端规则确认。
安装
npm install validator最小示例
import validator from "validator";
console.log(validator.isEmail("dev@example.com"));
console.log(validator.isURL("https://example.com"));什么时候用
适合对邮箱、URL、IP 等字符串做成熟的格式判断,减少重复编写正则。
使用边界
格式合法不代表真实存在,例如邮箱格式正确也不代表邮箱可收信。账号、域名、手机号等仍需业务验证或外部确认。
需要把不可信 HTML 插入页面前进行净化时可使用 DOMPurify;适合富文本展示和 XSS 防护的一环,不能替代完整输入输出安全策略。
DOMPurify HTML 清洗
需要把不可信 HTML 插入页面前进行净化时可使用 DOMPurify;适合富文本展示和 XSS 防护的一环,不能替代完整输入输出安全策略。
安装
npm install dompurify最小示例
import DOMPurify from "dompurify";
const dirty = `<img src=x onerror="alert(1)">`;
const clean = DOMPurify.sanitize(dirty);
document.querySelector("#content").innerHTML = clean;什么时候用
适合富文本、Markdown 转 HTML 后需要把不可信 HTML 安全插入浏览器 DOM 的场景。
使用边界
DOMPurify 是输出清洗的一环,不等于完整 XSS 防线。Node.js 服务端使用时还需要 DOM 环境适配,并应结合 CSP、编码和输入边界控制。
文本、Markdown 与展示
需要可扩展的 Markdown 解析和插件机制时可使用 markdown-it;适合文档、评论和内容系统,渲染不可信 HTML 时仍需额外清洗。
markdown-it Markdown 解析
需要可扩展的 Markdown 解析和插件机制时可使用 markdown-it;适合文档、评论和内容系统,渲染不可信 HTML 时仍需额外清洗。
安装
npm install markdown-it最小示例
import MarkdownIt from "markdown-it";
const md = new MarkdownIt({
html: false,
linkify: true,
});
console.log(md.render("# Hello"));什么时候用
适合文档、评论、知识库等需要 Markdown 解析并希望通过插件扩展规则的项目。
使用边界
若开启原始 HTML,应把内容视为不可信输入并额外清洗。不要认为 Markdown 解析器本身天然提供 XSS 防护。
需要快速把 Markdown 转成 HTML 时可使用 marked;API 简洁、适合轻量内容渲染,但输出内容本身不应默认视为安全 HTML。
Marked Markdown 解析
需要快速把 Markdown 转成 HTML 时可使用 marked;API 简洁、适合轻量内容渲染,但输出内容本身不应默认视为安全 HTML。
安装
npm install marked最小示例
import { marked } from "marked";
const html = marked.parse("## Hello\n\n**JavaScript**");
console.log(html);什么时候用
适合只需要快速把 Markdown 转成 HTML、API 简单且扩展需求不复杂的内容场景。
使用边界
解析结果是 HTML 字符串,不应直接信任用户输入产生的 HTML。显示不可信内容时要配合 DOMPurify 等清洗工具。
文档、博客和技术内容需要代码语法高亮时可使用 highlight.js;适合静态或运行时高亮,语言包和主题应按实际需求加载。
highlight.js 代码高亮
文档、博客和技术内容需要代码语法高亮时可使用 highlight.js;适合静态或运行时高亮,语言包和主题应按实际需求加载。
安装
npm install highlight.js最小示例
import hljs from "highlight.js";
const code = `const answer = 42;`;
const result = hljs.highlight(code, {
language: "javascript",
});
console.log(result.value);什么时候用
适合技术文章、Markdown、文档站和代码预览中按语言生成语法高亮 HTML。
使用边界
只加载实际使用的语言和样式能减少包体积。高亮解决展示问题,不负责代码执行安全,也不要把用户代码直接执行。
可视化与交互
需要折线、柱状、地图、关系图等丰富可视化能力时可选 Apache ECharts;适合业务看板和复杂图表,但应控制按需加载与实例生命周期。
ECharts 数据可视化
需要折线、柱状、地图、关系图等丰富可视化能力时可选 Apache ECharts;适合业务看板和复杂图表,但应控制按需加载与实例生命周期。
安装
npm install echarts最小示例
import * as echarts from "echarts";
const chart = echarts.init(document.querySelector("#chart"));
chart.setOption({
xAxis: { type: "category", data: ["Mon", "Tue", "Wed"] },
yAxis: { type: "value" },
series: [{ type: "line", data: [12, 18, 15] }],
});什么时候用
适合业务看板、关系图、地图和需要丰富交互能力的复杂数据可视化。
使用边界
组件销毁时应释放实例,频繁更新要避免重复初始化。简单图表不一定需要完整 ECharts 生态,可结合包体积和交互要求选择。
需要快速实现常见二维统计图表时可使用 Chart.js;API 相对直接,适合中小型看板,不以复杂关系图和大型可视分析为核心。
Chart.js 常用图表
需要快速实现常见二维统计图表时可使用 Chart.js;API 相对直接,适合中小型看板,不以复杂关系图和大型可视分析为核心。
安装
npm install chart.js最小示例
import Chart from "chart.js/auto";
new Chart(document.querySelector("#chart"), {
type: "bar",
data: {
labels: ["A", "B", "C"],
datasets: [{ data: [12, 19, 8] }],
},
});什么时候用
适合快速实现柱状图、折线图、饼图等常规统计图表,配置相对直接。
使用边界
大型关系网络、地理可视化和高度定制场景通常不是它的重点。频繁创建图表前要销毁旧实例并管理 Canvas 生命周期。