插件注册需确保路径正确、文件名合法(如zhihu_spider.py)、类继承统一基类且首字母大写,并显式调用register()函数;解析逻辑应隔离在各自parse()方法中,返回固定结构字典,网络请求由主框架统一管理。

插件怎么注册才不被主程序忽略
主程序找不到插件,八成是路径或命名没对上。Python 的 import 机制不会自动扫描子目录,得手动告诉它去哪找。
- 插件模块必须在 Python 路径里:要么放当前工作目录,要么加到
sys.path,别指望相对路径自动生效 - 文件名不能含破折号(
-),比如zhihu-spider.py会导入失败,得改成zhihu_spider.py - 插件类需继承统一基类(如
BaseSpider),且类名不能全小写——主程序通常靠inspect.getmembers扫描以大写字母开头的类 - 推荐加一个显式注册函数,比如
register(),在插件末尾调用,避免依赖 import 顺序
如何让不同网站的解析逻辑互不干扰
每个网站 DOM 结构、反爬策略、字段含义都不同,硬塞进一个 parse() 方法迟早爆炸。关键不是“怎么写解析”,而是“怎么隔离解析”。
- 每个插件实现自己的
parse(self, html: str) -> dict,返回结构固定(如必含title、content、url),字段值由自己负责清洗 - 禁止在插件里直接调用
requests.get()—— 网络层应由主框架统一管理(带 session 复用、User-Agent 轮换、重试逻辑) - 遇到 JS 渲染页面,插件可返回
{"requires_js": True},主程序再决定是否交给 Playwright,而不是每个插件都引入浏览器驱动 - 字段映射不要写死字符串,用配置字典(如
self.selectors = {"title": "h1", "content": ".article-body"}),方便测试时 mock
为什么 __init__.py 里写 from . import * 很危险
看似省事,实则破坏插件加载的确定性。主程序靠遍历目录 + 动态 import 加载插件,一旦 __init__.py 触发意外 import,整个插件目录可能提前报错退出。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 插件目录的
__init__.py应为空,或只写文档字符串,不执行任何导入或初始化 - 如果真要集中导出,用
__all__ = ["ZhihuSpider", "WeiboSpider"]显式声明,但主程序仍应按文件粒度 import,而非依赖from plugins import * - 常见坑:某个插件里写了
import torch,结果所有插件加载失败——主程序根本不知道这玩意儿该不该装,更不该为单个插件装全套 AI 库
插件热加载改了代码却没生效
Python 模块被 import 后就缓存在 sys.modules 里,不清理就不会重新加载。调试时看着改了,其实跑的还是旧字节码。
- 开发阶段务必加模块卸载逻辑:
del sys.modules["plugins.zhihu_spider"],再importlib.import_module() - 别用
reload()—— 它不处理模块间引用关系,容易出现“类是新的,但实例还是老的”这种诡异状态 - 生产环境别热加载,用进程级隔离:每个插件跑在独立子进程中,靠消息队列通信,崩溃不影响主流程
- 测试插件时,优先用
python -m pytest tests/test_zhihu_spider.py单独跑,绕过主程序加载链
插件架构真正的复杂点不在怎么写,而在边界怎么划:哪些该由插件决定(选择器、字段提取逻辑),哪些必须由主程序兜底(请求调度、异常归类、存储路由)。越早明确这条线,后期加新网站时就越少翻车。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










