知识库
前视偏差：用了未来才知道的信息去决定当下
如果你写过任何"策略回测"，并且跑出过漂亮得让自己心跳加速的收益曲线，那这篇文章大概率能戳到你——那条曲线里，常常藏着一个你根本没用到的秘密：未来数据。 现象 一个"确认型"策略（典型结构是：先出现信号 A，再等条件 B 确认后入场）回测出…
元组索引取错字段：一个下标让整套统计指标系统性偏小
批量处理数据文件时，你有没有遇到过这种事：脚本一行报错都没有，跑出来的数字"看着差不多，但就是对不上"？等你翻遍公式也找不出问题——因为错根本不在公式里，而在一个不起眼的下标。 现象 一个基于"距区间低点涨幅"的统计指标，算出来的数值系统性…
实时数据源偶发 IndexError——依赖外部通道的代码必须自带降级路径
一个从实时数据源取数的脚本，平时跑得好好的，偶尔却在半夜崩一次，报的还是一个跟你业务逻辑毫不相关的 IndexError。查来看去，问题不在你的代码，而在"那一刻对方没给数据"。 现象 脚本从某个实时数据源取数时，偶发以下错误： 或者干脆卡…
调用 GPU 运行时库报 201、错误码 1、未定义引用——一份 ABI 细节核对清单
要让脚本用上加速卡（GPU）的算力，就得去调它那套底层的运行时 API。这一步经常是"代码看着对、编译也能过，一跑就报一堆看不懂的错误码"。错误码不会告诉你原因，只能对照文档一项项核。 现象 调用某加速卡的运行时 API 时，错误花样百出，…
每次运行都刷 RequestsDependencyWarning——版本不匹配警告该在源头修
脚本功能一切正常，可每次运行都要先刷一行黄色警告，把真正的正常输出挤得看不见。命令行工具尤其难受：想看结果，得先拨开这行噪声。 现象 几乎每次运行脚本，输出开头都固定带着一行警告： 下面的业务输出就淹在这行下面。一行两行还好，对于那些要在循…
第三方接口库升级后报 KeyError——参数值与列名写死是升级时最先碎的地方
一个数据抓取脚本，之前一直跑得好好的。某天换了台机器，或者顺手把依赖库升级了一下，脚本就开始报错，而且报的是一个看起来莫名其妙的 KeyError——某个参数名的键不存在。整个数据块直接变空。 现象 升级某个第三方接口库之后，抓取时报错： …
缺依赖被笼统报成“数据超时”——异常分类被抹平后排查方向全歪
某段数据长期 100% 缺失，日志里清一色地写着"数据超时"。于是你顺着"网络不稳"的方向使劲：加重试、加延迟、换时段、换线路——全都不管用。真凶其实跟网络毫无关系，只是被日志误导了太久。 现象 一个抓取任务，某类数据长期拿不到，日志里稳定…
Windows 上 python3 指向应用商店占位程序——用真实解释器的绝对路径
在 Windows 上跑 Python 脚本，命令敲下去，脚本没跑起来。你以为装好了 Python，实际上系统里叫 python3 的那个东西，根本不是真的解释器。 现象 在命令行里执行： 有时会弹出应用商店窗口，有时直接失败或者行为诡异。…
系统自带的 Python 报 No module named pip——发行版拆包与三种替代安装方式
在一台 Linux 服务器上，想给系统自带的 Python 装个包，结果第一句话就卡住了：连 pip 都没有。明明 python3 能跑，import 也没问题，偏偏装不了任何东西。 现象 执行安装命令时直接失败： 或者： python3 …
pip 装包有的成功有的编译失败——本地少的是编译工具链，不是网络
在一台新机器上批量装 Python 包，大部分包顺利装上，偏偏有几个反复失败，报错里全是 C 编译器的身影。第一反应往往是"网络又抽风了"或者"镜像源有问题"，但换源、重试、换时段都无济于事——因为根本不是网络的事。 现象 执行安装命令时，…
功能上线一个月从未生效——同名键造成的“接线 bug”与如何验证功能真的在跑
有些 bug 只存在于"代码是否正确"和"功能是否生效"之间的那道缝里。一个功能上线将近一个月，代码安安静静地待在那里，测试也测不出来，可它 从来没有真正起过作用 。 现象 某个功能上线后，相关的分数（评分、权重、标签）一直没有任何变化，跟…
数据脚本每天重复全量下载——读写字段名不一致导致的“永远需要更新”
脚本每天雷打不动地完整下载一次大文件，哪怕本地明明就是最新的。加日志、加校验、手动比对，折腾半天才发现本地文件确实是新的——可脚本就是认为它旧。这种"永远需要更新"的毛病，根子常常不在逻辑，而在两个名字。 现象 一个数据更新脚本，每天无条件…
回测脚本被 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 脚本最常见的五类低级报错：类型、格式化、日期、引号与除零
一个人同时维护十几个数据分析、抓取、自动化脚本的时候，真正让人头大的往往不是那些复杂的算法问题，而是一批看起来"很低级"的小错误——它们出现的频率高得惊人，而且类型高度固定。 现象 一批脚本要么反复抛异常，要么算出来一组"不可能的数值"：占…
.gitignore 排除了文件，README 里的引用却成了死链
你在仓库里加了 .gitignore 规则，不让某些「本地专属」的文件入库——本地配置、私有的笔记、临时的机器说明。文件确实没进仓库，可推送之后，别人打开 README，发现里面指向这些文件的链接点不开，全是死链。 现象 .gitignor…