Mimic3安装时出现UnicodeDecodeError问题求助

错误详情 #

安装Mimic3 TTS时触发以下Unicode解码错误：

File "C:\Python311\Lib\pathlib.py", line 1059, in read_text
  return f.read()
         ^^^^^^^^
File "C:\Python311\Lib\encodings\cp1252.py", line 23, in decode
  return codecs.charmap_decode(input,self.errors,decoding_table)[0]
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
UnicodeDecodeError: 'charmap' codec can't decode byte 0x90 in position 707: character maps to <undefined>

已尝试的操作：

• 通过PyPI执行 pip install mycroft-mimic3-tts
• 临时设置环境变量 set PYTHONUTF8=1 和 set LANG=utf-8
• 从GitHub下载源码包执行 pip install -r requirements.txt
• 确认项目setup.py已指定用utf-8编码读取文件

问题分析 #

虽然项目自身的setup.py指定了utf-8编码，但Windows系统默认编码为cp1252，安装过程中可能存在以下情况导致错误：

1. pip或依赖包的安装脚本未显式指定编码读取文件，触发系统默认编码
2. 临时环境变量未正确传递到pip的子进程
3. 本地源码包中的部分文件实际编码不是utf-8（如带BOM的utf-8或其他编码）

解决方案 #

1. 安装时强制Python使用UTF-8编码 #

直接通过Python命令行参数强制全局编码为utf-8，避免环境变量传递问题：

python -X utf8 -m pip install mycroft-mimic3-tts

2. 永久设置Python编码环境变量 #

临时设置的环境变量仅对当前终端有效，可通过系统环境变量永久配置：

• 打开系统环境变量设置，新增系统变量 PYTHONUTF8，值设为 1
• 重启终端后重新执行安装命令

3. 修正本地源码文件编码 #

如果使用本地源码安装，检查并修正所有文本文件的编码：

• 用记事本打开README.md、requirements.txt等文件，选择「另存为」，编码选择「UTF-8」（无BOM），覆盖原文件
• 执行本地安装命令：

  pip install -e .
  

4. 使用虚拟环境隔离编码环境 #

创建独立虚拟环境，避免系统Python的编码配置干扰：

# 创建虚拟环境
python -m venv mimic3_env
# 激活虚拟环境（Windows cmd）
mimic3_env\Scripts\activate
# 激活虚拟环境（Windows PowerShell）
.\mimic3_env\Scripts\Activate.ps1
# 设置编码并安装
set PYTHONUTF8=1
pip install mycroft-mimic3-tts

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