启动Jupyter Lab报charmap解码UnicodeDecodeError，Jupyter Notebook正常

长期运行正常的Jupyter Lab突然启动报UnicodeDecodeError: 'charmap' codec can't decode byte 0x8d in position 12801，而同环境下的Jupyter Notebook可正常运行，这类报错本质是Windows平台下，程序读取本地配置/缓存文件时，文件编码和系统默认ANSI解码规则不匹配导致的，可按以下步骤逐层排查解决：

1. 优先验证编码匹配问题 #

在启动Jupyter Lab的命令行窗口先临时启用Python全局UTF-8模式，再启动服务：

set PYTHONUTF8=1
jupyter lab

如果启动后无报错，说明问题完全来自文件编码和系统默认解码规则的冲突，可继续按下面的步骤定位根因，不需要排查网络、依赖安装类的问题。

2. 修复Jupyter Lab配置文件编码 #

• 打开Windows资源管理器，地址栏输入%APPDATA%\jupyter进入Jupyter配置目录
• 找到目录下的jupyter_lab_config.py文件，使用Notepad++、VS Code等支持自定义编码的编辑器打开，不要用系统自带记事本
• 定位到报错提示的12801字节附近的内容，排查是否存在乱码、异常特殊字符，删除无效行
• 将整个配置文件重新以UTF-8 with BOM编码格式保存，避免Windows下Python读取时出现解码适配问题

3. 排查近期变更的Lab扩展与缓存文件 #

Jupyter Notebook的运行流程不依赖Lab专属的前端扩展加载与本地缓存，因此这类环节的文件编码异常只会触发Lab的报错：

• 在命令行运行jupyter labextension list，梳理所有安装的扩展，重点关注报错出现前最近更新、新安装的扩展
• 对可疑扩展执行临时禁用命令：jupyter labextension disable <对应扩展包名>
• 逐批禁用后重启Jupyter Lab，直到报错消失，即可定位到存在编码问题的扩展，后续可以选择重装该扩展、等待扩展作者更新修复，或者直接卸载
• 如果排查完扩展仍有报错，可以删除Jupyter Lab的本地缓存目录，路径是%LOCALAPPDATA%\jupyter\lab，删除后重启服务，Lab会自动重新生成缓存文件，排除旧缓存编码异常的影响

4. 核对系统区域编码设置 #

• 打开控制面板，进入「区域-管理-更改系统区域设置」界面
• 确认系统区域设置和日常使用的语言保持一致（比如中文简体环境就选择「中文（简体，中国）」）
• 如果界面上的「Beta版：使用Unicode UTF-8提供全球语言支持」选项处于勾选状态，可先取消勾选，重启电脑后再测试启动Jupyter Lab

内容的提问来源于stack exchange，提问作者Gaurav Bhattacharjee