Jupyter Lab使用Panel时Unicode解码错误的解决方法（无需改系统语言）

问题原因 #

错误栈显示，Panel读取ipynb文件时使用了系统默认编码（Windows中文环境为cp950），但Jupyter Notebook文件（.ipynb）本身采用UTF-8编码，导致解码字节0xc3时失败。

无需修改系统语言的解决办法 #

方案1：通过环境变量强制Python使用UTF-8编码 #

在启动Jupyter Lab前，设置Python全局UTF-8编码环境变量：

• Windows命令行：

  set PYTHONUTF8=1 && jupyter lab
  

• PowerShell：

  $env:PYTHONUTF8=1; jupyter lab
  

该设置会让Python默认以UTF-8编码读取文件，无需修改任何代码。

方案2：修改Panel插件的源码文件 #

找到Panel安装目录下的panel/io/jupyter_server_extension.py文件（路径示例：E:\ProgramFile\python311\Lib\site-packages\panel\io\jupyter_server_extension.py），定位到文件读取相关代码段：
原代码可能为：

with open(nb_path) as f:
    nb = json.load(f)

修改为指定UTF-8编码打开文件：

with open(nb_path, encoding='utf-8') as f:
    nb = json.load(f)

保存文件后重启Jupyter Lab即可生效。

方案3：临时会话级编码设置（仅当前Notebook有效） #

在使用Panel前，执行以下代码强制Python默认编码为UTF-8：

import sys
import codecs
sys.stdout = codecs.getwriter('utf-8')(sys.stdout.detach())
sys.stderr = codecs.getwriter('utf-8')(sys.stderr.detach())

此方案仅对当前Notebook会话有效，重启后需重新执行，优先级低于前两种方案。

内容的提问来源于stack exchange，提问作者acg zelda