一、前言

最近着手系统学习 AI Agent 智能体开发，需要搭建一套2026年最新、兼容性最优的Python运行环境，核心依赖三个关键库：openai、click、python-dotenv。

不同于普通Python项目，AI Agent开发对库版本兼容性要求极高：新版OpenAI SDK重构了底层语法，旧版本库无法支持Assistant API v2、函数调用、RAG等核心Agent能力。因此必须安装指定最新稳定兼容版本：

• openai==1.73.0（2026最新稳定版，支持全套Agent功能）

• click==8.3.3（最新稳定命令行工具，适配Agent终端交互）

• python-dotenv==1.2.2（最新环境变量管理工具，安全存储密钥）

但在Windows系统直接安装时，遭遇了经典的系统文件报错，本文完整记录报错原因、踩坑过程、终极解决方案，以及环境校验、适配AI Agent的全套搭建流程，新手可直接复刻。

一、问题复现

1. 初始安装命令

执行常规批量安装指令：

pip install openai==1.73.0 click==8.3.3 python-dotenv==1.2.2

2. 报错信息

ERROR: Could not install packages due to an OSError: [WinError 2] 系统找不到指定的文件。: 'C:\\Python312\\Scripts\\dotenv.exe' -> 'C:\\Python312\\Scripts\\dotenv.exe.deleteme'

3. 原因分析

该报错是 Windows 专属问题，并非版本冲突或命令错误：

1. 旧版 dotenv.exe 被终端、代码编辑器、Python 进程占用，无法被删除 / 替换；
2. 普通终端权限不足，没有权限修改 Python 安装目录下的脚本文件。
3. 尝试强制重装、清空缓存、分步卸载重装后依旧无效。

二、解决方案（亲测 100% 成功）

步骤 1：关闭占用程序

关闭所有 CMD/PowerShell、VSCode/PyCharm 等编辑器，结束后台 Python 相关进程，避免文件被锁定。

步骤 2：管理员身份打开终端

1. 开始菜单搜索 cmd；
2. 右键「命令提示符」，选择以管理员身份运行。

步骤 3：执行安装命令

在高权限终端中重新执行安装指令：

pip install openai==1.73.0 click==8.3.3 python-dotenv==1.2.2

等待执行完成，无报错即安装完毕。

三、环境校验

1. 查看库版本

pip show openai click python-dotenv

正常结果：

• openai: 1.73.0
• click: 8.3.3
• python-dotenv: 1.2.2

2. 代码导入测试

新建 check_env.py，验证库能否正常导入：

try:
    import openai
    import click
    from dotenv import load_dotenv
    print("✅ 所有库导入成功！")
    print(f"openai 版本: {openai.__version__}")
    print(f"click 版本: {click.__version__}")
    
    import importlib.metadata
    print(f"python-dotenv 版本: {importlib.metadata.version('python-dotenv')}")
    
except Exception as e:
    print("❌ 环境异常:", e)

运行脚本，无异常输出代表环境完全可用。

四、库作用说明（Agent 学习场景）

1. openai 1.73.0：官方新版 SDK，重构语法，全面支持函数调用、向量检索、Assistant API v2 等 Agent 核心功能，老旧 0.28.1（俗称 2.8.1）版本已不再适配新能力。
2. click 8.3.3：快速实现命令行交互，方便调试、运行终端版 Agent。
3. python-dotenv 1.2.2：将 API 密钥等敏感配置写入 .env 文件，避免硬编码，是项目开发规范。

五、总结 & 避坑

1. Windows 出现 WinError 2 文件相关报错，优先检查文件占用和管理员权限 ，无需反复折腾版本；
2. 学习 AI Agent 务必使用 openai 1.x 系列稳定版，旧版 0.x 语法不兼容新版接口；
3. 推荐环境组合：Python3.10~3.12 + openai1.73.0 + click8.3.3 + python-dotenv1.2.2，2026 年稳定无冲突。