如何配置codespell以忽略Jupyter笔记本中Base64字符串的误报？

我正在为大量使用Jupyter笔记本的代码库配置codespell。在包含Base64编码嵌入图片的笔记本中，codespell产生了大量误报——/和+被当作单词边界，长Base64字符串里会触发ue->use, due这类拼写检查规则。

我曾尝试使用ignore-regex选项，但该选项仅对拆分后的单词生效，无法跳过整段Base64文本。请问如何让codespell彻底忽略这些Base64编码字符串？

最小复现示例 #

CkNvZGV+ue/+ue+zcGVsbCB0aHJvd3MgYSBsb3Qgb2YgZmFsc2UgcG9zaXRpdmVzIG9uIGEgbm90ZWJvb2sgdGhhdCBjb250YWlucyBpbWF

codespell运行结果 #

$ codespell
./test.py:1: ue ==> use, due
./test.py:1: ue ==> use, due

解决方法 #

1. 通过配置文件匹配Base64模式整段跳过 #

创建或修改项目根目录下的.codespellrc配置文件，添加regex_skip规则匹配标准Base64字符串，让codespell直接跳过这类文本：

[codespell]
# 匹配由字母、数字、+、/组成，结尾可能带1-2个=的Base64字符串
regex_skip = \b[A-Za-z0-9+/]+={0,2}\b

这个正则会覆盖大多数嵌入图片的Base64编码场景，彻底跳过整段编码内容，避免误报。

2. 针对Jupyter笔记本的精细化处理 #

如果不想完全跳过.ipynb文件，仅忽略其中的图片Base64部分，可以使用jupyter nbconvert提取笔记本中的代码和文本内容，再用codespell检查提取后的文件：

jupyter nbconvert --to markdown *.ipynb && codespell *.md

这种方式既能检查笔记本里的有效内容，又能避开Base64编码的干扰。

3. 用ignore-regex针对性抑制误报 #

若暂时无法配置整段跳过，可通过ignore-regex匹配Base64中的误报片段，比如针对ue的误报：

codespell --ignore-regex='ue(?=[A-Za-z0-9+/])'

该规则会忽略后面紧跟Base64字符的ue，减少误报，但不如整段跳过彻底。

内容的提问来源于stack exchange，提问作者Cornelius Roemer