Scrapling 安装教程：一条命令装好，2 行代码跑通你的第一个爬虫

Scrapling 安装教程：一条命令装好，2 行代码跑通你的第一个爬虫

【免费下载链接】Scrapling🕷️ A Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev项目地址: https://gitcode.com/GitHub_Trending/sc/Scrapling

Scrapling 是一个 Python 爬虫框架，一次请求到整站抓取都能接住：它的选择器带"自适应"能力，页面改版后能按相似度重新定位元素，内置的 Fetcher 还能绕过 Cloudflare 之类的反爬。本文带你用一条命令完成 Scrapling 安装，再用 2 行代码验证爬虫真的跑通了。

环境要求：先确认 Python 版本

Scrapling 硬性要求 Python 3.10 及以上（见 pyproject.toml 中的requires-python = ">=3.10"）。敲一下：

python --version

打印出Python 3.10.x或更高就继续往下走。Linux 和 macOS 上经常没有python命令，换成python3即可。版本不够的话先去装一个新版 Python，这是安装前唯一要处理的事。

安装命令：带上 fetchers 扩展

pip install "scrapling[fetchers]"

为什么要带[fetchers]？裸装pip install scrapling只给你解析引擎，fetchers 模块的所有请求依赖（curl_cffi、playwright 等）都放在这个可选扩展里。不带后缀装完，一调用Fetcher发请求就会抛ModuleNotFoundError。

国内网络超时或找不到包时，先给 pip 换镜像源再原样重跑这条命令。

跑通验证：2 行代码发一次真实请求

新建test_scrapling.py，写入下面 2 行，然后运行python test_scrapling.py：

from scrapling.fetchers import Fetcher page = Fetcher.get('https://quotes.toscrape.com/') print(page.status, page.css('title::text').get())

终端打印出200 ...，说明 Scrapling 安装链路全部打通。第一行是 HTTP 状态码，第二行是页面标题——请求和解析两个环节都走通了。

注意这里是类方法调用，不用先Fetcher()实例化。底层 HTTP 走 curl_cffi，默认 30 秒超时、自动重试 3 次，参数细节都有文档。

报错处理：3 个新手最常踩的坑

ModuleNotFoundError: No module named 'curl_cffi'

原因只有一个：装成了裸包。带上后缀重装：

pip install "scrapling[fetchers]"

DynamicFetcher / StealthyFetcher 打不开浏览器

这两个 Fetcher 靠真实浏览器渲染，pip 装完后浏览器依赖还没下载。再补一条命令即可：

scrapling install

它会下载 Chromium 及配套的指纹伪装依赖；重装环境后想强制重下，加--force参数。

requires Python >=3.10

pip 直接拒绝安装，说明当前解释器版本不够。升级 Python 后重跑安装命令就行，前面"环境要求"一节讲过怎么检查。

下一步：按场景升级玩法

装通之后，换 Fetcher 只需改一个类名，上面的代码结构不用动。

• 目标页面是 JS 渲染的（数据靠脚本注入、静态 HTML 里根本没有），看 Fetcher 选型，对照表格换DynamicFetcher。
• 站点带 Cloudflare 拦截、常规请求被拒，看 StealthyFetcher 文档，它支持自动过 Turnstile 验证。
• 想边敲边试、不写脚本，直接scrapling shell进内置的交互式爬虫 Shell，用法见 CLI 概览。

解析引擎核心实现在 scrapling/parser.py，想弄清自适应选择器怎么工作可以翻源码。

【免费下载链接】Scrapling🕷️ A Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev项目地址: https://gitcode.com/GitHub_Trending/sc/Scrapling