Windows10下VS2019调试KiCad时出现Python文件系统编码致命错误

核心原因 #

该崩溃是调试环境中Python运行时无法正确识别系统文件系统编码导致的，通常和KiCad调试时的Python环境配置缺失、系统编码设置不兼容，或是VS调试环境未正确继承系统编码环境变量有关，同时伴随的nlohmann::json解析错误也可能是配置文件生成异常引发的连锁问题。

解决方案 #

1. 配置调试环境的Python依赖路径 #

KiCad 7.x依赖特定版本的Python（通常为Python 3.9.x，需与KiCad编译时使用的版本完全匹配）：

• 在VS2019的调试属性→环境中，添加PYTHONHOME变量，值为你的Python安装根目录（例如C:\Python39）
• 添加PYTHONPATH变量，值为$(PYTHONHOME)\Lib;$(PYTHONHOME)\DLLs
• 将Python安装目录的Scripts和DLLs路径追加到PATH环境变量中

2. 强制统一编码环境变量 #

在VS调试环境变量中添加以下项，强制Python使用UTF-8编码：

• PYTHONUTF8=1
• LC_ALL=en_US.UTF-8
• LANG=en_US.UTF-8

3. 修复KiCad配置文件异常 #

由于输出存在nlohmann::json解析错误，可手动初始化配置目录：

• 手动创建路径：%APPDATA%\Roaming\kicad\7.0
• 在该目录下创建空的kicad.json文件，或从正常运行的KiCad实例中复制一份同版本的配置文件到此处
• 确保该目录及文件拥有读写权限

4. 确保VS调试环境继承系统编码 #

• 打开VS2019的开发者命令提示符，输入chcp确认当前代码页为UTF-8（65001），若不是则执行chcp 65001后再启动VS
• 在VS调试属性中勾选使用继承的环境选项，避免环境变量被截断

5. 匹配编译与调试的Python版本（自行编译KiCad时） #

• 确认编译KiCad时使用的Python版本和调试环境中的版本完全一致（包括32/64位）
• 重新编译时，在CMake配置中明确指定Python路径：

  -DPYTHON_EXECUTABLE=C:\Python39\python.exe
  -DPYTHON_INCLUDE_DIR=C:\Python39\include
  -DPYTHON_LIBRARY=C:\Python39\libs\python39.lib
  

验证步骤 #

1. 配置完成后重启VS2019
2. 重新启动调试，选择“Start with Default Settings”
3. 观察输出窗口是否不再出现Python编码致命错误，确认KiCad正常启动

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