Windows环境安装manim-voiceover时出现UnicodeDecodeError求助

错误根源 #

问题出在依赖包humanhash3的setup.py文件中：读取项目说明文件时未指定UTF-8编码，Windows环境默认用CP949编码解析包含特殊字符的文本，导致解码失败。PYTHONIOENCODING环境变量仅作用于终端输入输出，不影响文件读取，因此无法解决该问题。

解决方案 #

方法一：手动修复humanhash3源码后安装

1. 下载humanhash3 0.0.6版本源码包：

   pip download humanhash3==0.0.6
   

2. 解压下载的humanhash3-0.0.6.tar.gz文件
3. 打开解压目录中的setup.py，找到以下代码：

   long_description = f.read()
   

   修改为：

   long_description = f.read(encoding='utf-8')
   

4. 进入解压后的目录，执行本地安装：

   pip install .
   

5. 最后安装manim-voiceover：

   pip install manim-voiceover
   

方法二：临时设置Python默认编码（Python 3.7+适用）

在命令行中先执行以下命令，再安装manim-voiceover：

set PYTHONUTF8=1
pip install manim-voiceover

该环境变量会强制Python以UTF-8编码打开文件，临时绕过编码冲突问题。

方法三：跳过依赖自动安装，手动补全依赖

1. 先安装manim-voiceover的其他必要依赖：

   pip install pydub mutagen python-dotenv
   

2. 安装manim-voiceover时跳过依赖检查：

   pip install manim-voiceover --no-deps
   

注意：此方法需确保所有依赖已正确安装，否则可能导致manim-voiceover功能异常。

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