知识库
实时数据源偶发 IndexError——依赖外部通道的代码必须自带降级路径
一个从实时数据源取数的脚本，平时跑得好好的，偶尔却在半夜崩一次，报的还是一个跟你业务逻辑毫不相关的 IndexError。查来看去，问题不在你的代码，而在"那一刻对方没给数据"。 现象 脚本从某个实时数据源取数时，偶发以下错误： 或者干脆卡…
调用 GPU 运行时库报 201、错误码 1、未定义引用——一份 ABI 细节核对清单
要让脚本用上加速卡（GPU）的算力，就得去调它那套底层的运行时 API。这一步经常是"代码看着对、编译也能过，一跑就报一堆看不懂的错误码"。错误码不会告诉你原因，只能对照文档一项项核。 现象 调用某加速卡的运行时 API 时，错误花样百出，…
第三方接口库升级后报 KeyError——参数值与列名写死是升级时最先碎的地方
一个数据抓取脚本，之前一直跑得好好的。某天换了台机器，或者顺手把依赖库升级了一下，脚本就开始报错，而且报的是一个看起来莫名其妙的 KeyError——某个参数名的键不存在。整个数据块直接变空。 现象 升级某个第三方接口库之后，抓取时报错： …
缺依赖被笼统报成“数据超时”——异常分类被抹平后排查方向全歪
某段数据长期 100% 缺失，日志里清一色地写着"数据超时"。于是你顺着"网络不稳"的方向使劲：加重试、加延迟、换时段、换线路——全都不管用。真凶其实跟网络毫无关系，只是被日志误导了太久。 现象 一个抓取任务，某类数据长期拿不到，日志里稳定…
Windows 上 python3 指向应用商店占位程序——用真实解释器的绝对路径
在 Windows 上跑 Python 脚本，命令敲下去，脚本没跑起来。你以为装好了 Python，实际上系统里叫 python3 的那个东西，根本不是真的解释器。 现象 在命令行里执行： 有时会弹出应用商店窗口，有时直接失败或者行为诡异。…
pip 装包有的成功有的编译失败——本地少的是编译工具链，不是网络
在一台新机器上批量装 Python 包，大部分包顺利装上，偏偏有几个反复失败，报错里全是 C 编译器的身影。第一反应往往是"网络又抽风了"或者"镜像源有问题"，但换源、重试、换时段都无济于事——因为根本不是网络的事。 现象 执行安装命令时，…
数据脚本每天重复全量下载——读写字段名不一致导致的“永远需要更新”
脚本每天雷打不动地完整下载一次大文件，哪怕本地明明就是最新的。加日志、加校验、手动比对，折腾半天才发现本地文件确实是新的——可脚本就是认为它旧。这种"永远需要更新"的毛病，根子常常不在逻辑，而在两个名字。 现象 一个数据更新脚本，每天无条件…
回测脚本被 O(N²) 拖到超时（退出码 124）——滑动指标该预计算缓存
脚本逻辑明明是对的，小样本跑得也好好的，可数据量一上来就被系统杀掉，退出码 124。你翻遍日志找不到任何报错——因为根本没报错，是"跑得太慢被掐死了"。 现象 回测脚本或面板在跑全量数据时被强制终止： 退出码 124 是 timeout 命…
删掉功能代码后脚本仍报错——残留的 import 与函数定义怎么清干净
想从一个面板脚本里删掉一块不再需要的功能，删完运行，脚本还是报错——说找不到某个模块。可你明明已经把用到它的那段逻辑删了。问题在于：你以为删干净了，其实引用它的地方还在。 现象 从脚本里删掉某个功能区块后，程序启动即失败： 或者： 打开文件…
复用现成下载器类报 TypeError: key must be bytes-like——别忽略代码没写出来的假设
手里已经有一个跑得好好的下载器类，现在要拿它去处理另一种来源的数据。你会觉得：都是下载，接口应该差不多，直接复用就行了。结果一分片就报错，而且报的错跟你想排查的方向完全对不上。 现象 用现成的下载器类去处理另一类数据源时，程序在分片阶段全部…
Python 标准库抓网页拿回一堆“乱码”，其实是 gzip 没解压
用 Python 标准库去抓一个网站，read() 回来一看：满屏 \x1f\x8b\x08... 之类的字节，复制到编辑器里也是一堆乱码。第一反应是"对方是不是返回了异常内容"，甚至怀疑自己请求错了地址。其实对方返回的完全正常，只是你少解…
封装函数重复拼接 URL 出错，却被报成“全部超时”——被吞掉的异常有多坑
一个监控客户端，列表里十几个节点全部显示"不通"。第一反应当然是网络问题：挨个 ping、查防火墙、翻交换机日志，折腾大半天毫无头绪。真正的元凶其实藏在代码里，而且它一开始就伪装成了"超时"。 现象 客户端里所有节点统一报"请求超时／连接不…
Python 报 SyntaxError: name 'X' is used prior to global declaration 的前因后果
给一个已经跑得好好的脚本加上"在函数里修改模块级常量"的能力，是再常见不过的需求。可有时候你只是往函数里插了一行 global，脚本就直接编译不过了。 现象 你给一个函数加上模块级变量的修改逻辑，运行时得到这样的报错： 注意这是一个 Syn…
Python 脚本最常见的五类低级报错：类型、格式化、日期、引号与除零
一个人同时维护十几个数据分析、抓取、自动化脚本的时候，真正让人头大的往往不是那些复杂的算法问题，而是一批看起来"很低级"的小错误——它们出现的频率高得惊人，而且类型高度固定。 现象 一批脚本要么反复抛异常，要么算出来一组"不可能的数值"：占…
路径写进 Python 字符串报 unicodeescape 错误：反斜杠转义入门
你用 Python 生成一段脚本内容，或者在自己的代码里写了一个 Windows 路径，运行直接报语法错误，报的还是一条看不懂的 unicodeescape。你盯着那行代码，路径明明是复制粘贴过来的，绝对没错。 现象 或者： 报错会 指到你…
一个坏文件拖垮整轮批量任务：Python 读取时的编码容错
你写了个批量脚本，要扫描几千个文件、从中检索关键词。前几百个跑得好好的，突然进程整个崩掉，报一个 UnicodeDecodeError。等你去查，发现「肇事」的只是其中一个编码不规范的小文件。为了这一个文件，整轮任务白跑了。 现象 或者： …
用中文关键词搜索返回零结果：查询串编码对不上时的排查与修法
你写了个脚本去某个站点搜索，英文关键词一搜一个准，换成中文关键词，返回的结果永远是 0 条。试了好几个不同的中文词，全是空。你开始怀疑「这个站是不是压根没有中文资源」，甚至怀疑站点封了你。 现象 同一个接口，?q=python 有结果，?q…
抓取中文域名抛 UnicodeEncodeError：IDNA 与 Punycode 入门
你写了个脚本去抓一批站点，源清单里混进了几个中文域名。程序跑到这几个就抛异常退出，报的还是个跟网络八竿子打不着的编码错误。更坑的是，这个错误把真正的网络问题也一起盖住了，你对着 UnicodeEncodeError 排查了半天网络，方向全错…
Python 打印中文或 emoji 就崩：Windows 控制台 stdout 的 GBK 编码陷阱
脚本在家里那台 Linux 机器上跑得好好的，搬到 Windows 上，只要一打印带 emoji 的状态行，或者输出几句中文，就直接抛异常退出。更气人的是它退出的时机——往往正好在「已经改了一半数据、还没写回文件」的中间状态，留下一堆需要手…
Rust 所有权机制入门：为什么它能在编译期消灭一大类内存错误
引言 在 C/C++ 中，内存错误（如悬垂指针、双重释放、内存泄漏）是常见且难以调试的问题。Rust 通过独特的所有权（Ownership）机制，在编译期就消除了这些错误，而无需垃圾回收。本文将带你理解所有权的基本规则和它如何工作。 所有权…