使用xlwings在VS Code导入VBA模块时的特殊字符问题

问题核心是xlwings默认用Windows系统编码（比如cp1252）处理VBA模块，而非UTF-8。哪怕VS Code全局设了UTF-8，编码不匹配仍会导致特殊字符乱码，保存后还会同步回Excel破坏原内容。试试以下解决方法：

临时应急方案（手动指定编码） #

• 先避开xlwings vba edit，用导出命令指定编码：

  xlwings vba export --encoding cp1252
  

• 在VS Code中打开导出的文件，点击右下角的编码标识（默认显示UTF-8），选择「通过编码重新打开」，选「Windows 1252」，此时特殊字符应正常显示
• 修改完成后，用指定编码导回Excel：

  xlwings vba import --encoding cp1252
  

永久配置方案（让xlwings默认用正确编码） #

方法1：通过Python代码设置 #

在项目脚本中添加：

import xlwings as xw
# 将默认VBA编码设为cp1252（适配西欧语言的Windows编码）
xw.settings.set("vba_encoding", "cp1252")

方法2：修改xlwings配置文件 #

• Windows：打开%APPDATA%\xlwings\xlwings.conf文件，添加一行：

  vba_encoding = cp1252
  

• macOS：打开~/Library/Application Support/xlwings/xlwings.conf文件，添加同样内容
• 配置完成后，再用xlwings vba edit时，xlwings会自动用cp1252编码处理模块

辅助优化：开启VS Code自动编码检测 #

打开VS Code设置，搜索files.autoGuessEncoding并勾选，VS Code会自动检测文件实际编码，无需手动切换。

验证：修改保存后导回Excel，检查ä/ö/ü等字符是否正常显示，确认同步后无乱码。

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