Kokoro-FastAPI项目Windows环境UTF-8编码问题解决方案

在Windows环境下运行Kokoro-FastAPI项目时，开发者可能会遇到一个常见的编码问题。这个问题表现为在构建过程中出现UnicodeDecodeError错误，具体提示为"charmap codec can't decode byte 0x8f"。

该问题的根源在于Windows系统默认使用的编码格式与Python项目期望的UTF-8编码不兼容。当项目包含非ASCII字符（如特殊符号或非英语字符）时，Windows默认的cp1252编码无法正确解析这些字符，导致构建失败。

解决这个问题的有效方法是在运行脚本前设置PYTHONUTF8环境变量。这个环境变量会强制Python使用UTF-8编码来处理所有文本输入输出，从而避免编码冲突。具体实现方式有两种：

1. 在命令行中临时设置：

set PYTHONUTF8=1

2. 在批处理文件中永久设置：

@echo off
set PYTHONUTF8=1
REM 其他命令...

对于Kokoro-FastAPI项目，建议创建一个专门的Windows启动脚本，完整示例如下：

@echo off
REM 设置项目根目录
for /f "delims=" %%i in ('cd') do set "PROJECT_ROOT=%%i"

REM 设置环境变量
set PYTHONUTF8=1
set USE_GPU=true
set USE_ONNX=false
set PYTHONPATH=%PROJECT_ROOT%;%PROJECT_ROOT%\api
set MODEL_DIR=src\models
set VOICES_DIR=src\voices\v1_0
set WEB_PLAYER_PATH=%PROJECT_ROOT%\web

REM 安装GPU支持并启动服务
call uv pip install -e ".[gpu]"
call uv run uvicorn api.src.main:app --reload --host 0.0.0.0 --port 8880

这个解决方案不仅适用于Kokoro-FastAPI项目，对于其他在Windows上运行的Python项目遇到类似编码问题时也同样有效。它确保了项目能够在不同操作系统环境下保持一致的编码处理方式，提高了代码的可移植性。

值得注意的是，随着Python版本的更新，UTF-8编码在Windows上的支持越来越好。但在某些特定情况下，特别是使用较旧版本的Python或特定构建工具时，显式设置PYTHONUTF8环境变量仍然是一个可靠的最佳实践。