UtterType项目Windows系统下OpenAI API密钥配置指南

UtterType项目Windows系统下OpenAI API密钥配置指南

环境变量配置差异解析

在跨平台开发过程中，环境变量的设置方式存在显著差异。UtterType作为基于Python的语音转写工具，需要正确配置OpenAI API密钥才能正常运行。Windows系统与Unix-like系统在环境变量处理机制上的不同，是导致配置失败的根本原因。

Windows系统下的三种配置方案

方案一：PowerShell临时环境变量

对于Windows 10/11用户，推荐使用PowerShell进行临时变量配置：

$env:OPENAI_API_KEY="sk-your-api-key-here"

此方式仅在当前会话有效，关闭终端后自动失效，适合临时测试场景。

方案二：永久环境变量配置

1. 右键"此电脑"选择"属性"
2. 进入"高级系统设置"→"环境变量"
3. 在"用户变量"或"系统变量"中新建：
   • 变量名：OPENAI_API_KEY
   • 变量值：sk-your-api-key-here
4. 重启所有命令行工具使配置生效

方案三：.env文件配置（推荐）

1. 在项目根目录创建.env文件
2. 写入以下内容（注意无引号）：

OPENAI_API_KEY=sk-your-api-key-here

3. 确保项目已安装python-dotenv包：

pip install python-dotenv

常见问题排查

1. 文件扩展名问题： Windows默认隐藏已知扩展名，确保创建的.env文件不是.env.txt

2. 权限问题： 右键文件→属性→取消"只读"选项

3. 编码格式： 使用记事本保存时选择"UTF-8"编码

4. 路径验证： 可通过以下Python代码验证环境变量是否加载成功：

import os
print(os.getenv('OPENAI_API_KEY'))

安全注意事项

1. 永远不要将.env文件提交到版本控制系统
2. 在公共场合使用时建议采用临时环境变量
3. 定期轮换API密钥
4. 为开发和生产环境使用不同的密钥

通过以上方法，Windows用户可以顺利完成UtterType项目的API密钥配置，确保语音转写功能的正常使用。建议开发者优先采用.env文件方案，既保证安全性又便于多环境管理。