Cheerio.js: 快速、灵活且优雅的HTML与XML解析库

2026-01-18 09:15:48作者：裘旻烁

轻量级解析工具，采用 jQuery 核心语法，高效处理 HTML/XML 文档。兼具速度与灵活性，支持浏览器和服务器环境，轻松实现元素选择、修改与渲染。

项目地址：https://gitcode.com/gh_mirrors/che/cheerio

项目介绍

Cheerio.js 是一个专为Node.js设计的轻量级库，它提供了类似于jQuery的语法来解析、操作和渲染HTML及XML文档。通过实施核心jQuery的一个子集，Cheerio剔除了与DOM的一致性问题和浏览器特有的杂乱部分，展现了其简洁高效的API。这使得开发者能够在服务器端以熟悉的方式处理HTML，极大提高了开发效率与体验。Cheerio的速度得益于其基于简单一致的DOM模型工作，从而在解析、操纵以及渲染过程中保持了极高的性能。

项目快速启动

要快速开始使用Cheerio，首先确保你的开发环境中已经安装了Node.js。接着，通过npm（Node包管理器）安装Cheerio：

npm install cheerio

之后，在你的Node.js项目中，你可以按照以下方式引入并使用Cheerio：

const cheerio = require('cheerio');
// 加载HTML字符串
const $ = cheerio.load('<h2 class="title">Hello world</h2>');
// 修改文本
$('h2.title').text('你好，世界！');
// 添加类名
$('h2').addClass('welcome');
// 输出结果
console.log($.html());
// => <html><head></head><body><h2 class="title welcome">你好，世界！</h2></body></html>

这段代码展示了如何加载HTML，选择元素，修改文本内容，并添加CSS类。

应用案例和最佳实践

网页抓取与数据提取

Cheerio常用于从Web页面中提取特定的数据，例如新闻文章标题或产品信息。以下是简单的网页抓取示例，结合axios进行HTTP请求：

const axios = require('axios');
const cheerio = require('cheerio');

axios.get('http://example.com')
  .then(res => {
    const $ = cheerio.load(res.data);
    // 假设我们要提取所有文章标题
    $('article h2').each((i, element) => {
      console.log($(element).text());
    });
  })
  .catch(err => console.error(err));

最佳实践:

安全第一: 处理不可信的HTML时要小心，避免XSS攻击。
选择合适的选择器: 使用精确的CSS选择器来提高性能。
异步处理: 在网络请求和文件读写等IO密集型操作时使用异步函数。

典型生态项目

虽然Cheerio本身并不依赖于特定的框架或生态系统，但它在多个场景下成为关键工具，尤其是与爬虫、静态站点生成器和API构建相关的项目中。例如，与Puppeteer 结合可以提供完整的客户端执行环境，而与Gatsby这样的静态站点生成框架一起使用时，能够高效地处理和预渲染内容。

Cheerio因其轻量级、灵活性以及对服务器端JavaScript开发的友好支持，成为了许多数据抓取和自动化项目的首选库，广泛应用于内容迁移、SEO优化、数据分析等领域。

以上就是关于Cheerio.js的基本介绍、快速启动指南、应用案例与最佳实践的概述，希望对你理解和使用Cheerio有所帮助。

轻量级解析工具，采用 jQuery 核心语法，高效处理 HTML/XML 文档。兼具速度与灵活性，支持浏览器和服务器环境，轻松实现元素选择、修改与渲染。

项目地址：https://gitcode.com/gh_mirrors/che/cheerio

登录后查看全文

热门内容推荐

1 【亲测免费】开源项目 `build-your-own-x` 使用指南 2 【亲测免费】探索科技之旅：《Build Your Own X》项目详解 3 GitHub_Trending/bu/build-your-own-x自动化：CI/CD流程在自制项目中的应用 4 从零打造智能家居系统：用build-your-own-x实现家庭自动化

最新内容推荐

pi-mono自定义工具开发实战指南：从入门到精通 3个实时风控价值：Flink CDC+ClickHouse在金融反欺诈的实时监测指南 Docling 实用指南：从核心功能到配置实践自动化票务处理系统在高并发抢票场景中的技术实现：从手动抢购痛点到智能化解决方案 OpenCore Legacy Patcher显卡驱动适配指南：让老Mac焕发新生 7个维度掌握Avalonia：跨平台UI框架从入门到架构师 Warp框架安装部署解决方案：从环境诊断到容器化实战指南突破移动瓶颈：kkFileView的5层适配架构与全场景实战指南革新智能交互：xiaozhi-esp32如何实现百元级AI对话机器人如何打造专属AI服务器？本地部署大模型的全流程实战指南

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

flutter_flutter

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

RuoYi-Cloud-Vue3

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统

昇腾LLM分布式训练框架