本文详解 OpenAI 官方 SDK 从 v3 升级至 v4 后的导入方式变更，帮助开发者快速修复 Module not found 或 TypeError: Module name does not resolve 等常见错误，并提供完整可运行示例。
本文详解 openai 官方 sdk 从 v3 升级至 v4 后的导入方式变更，帮助开发者快速修复 `module not found` 或 `typeerror: module name does not resolve` 等常见错误，并提供完整可运行示例。
OpenAI 官方 SDK 在 2023 年底发布 v4 版本（即 openai@4.x），这是一个重大版本更新，彻底重构了模块导出机制：v4 不再默认导出 Configuration 和 OpenAIApi 类，而是采用单一默认导出（default export） —— 即 OpenAI 实例类。因此，你当前使用的 import { Configuration, openAIApi } from "openai" 语法（注意大小写错误：openAIApi 应为 OpenAIApi）仅适用于已废弃的 v3 版本，而在 v4 中会直接报错：Module name 'openai' does not resolve to a valid URL（尤其在 ESM 环境下）。
✅ 正确做法（v4 推荐写法）：
// server.js — 使用 ES Module 语法（需 package.json 中 type: "module"）
import OpenAI from 'openai';
const openai = new OpenAI({
apiKey: process.env.OPENAI_API_KEY, // 强烈建议从环境变量读取
});
async function generateText() {
try {
const response = await openai.chat.completions.create({
model: "gpt-3.5-turbo",
messages: [{ role: "user", content: "简述人工智能的定义" }],
});
console.log(response.choices[0].message.content);
} catch (error) {
console.error("API 调用失败:", error.message);
}
}
generateText();
⚠️ 注意事项：
-
确认 SDK 版本：运行
npm list openai查看实际安装版本。若显示openai@3.x，请先升级：npm install openai@latest； -
环境变量安全：切勿将 API Key 硬编码在代码中。使用
.env文件 +dotenv包加载更安全； -
运行环境限制：
openai是 Node.js 服务端 SDK，不可直接在浏览器或public/前端目录中使用（你提到脚本位于public/文件夹，这是典型错误——Node.js 无法解析前端静态目录中的 ESM 导入）。所有 OpenAI 调用必须在server.js或后端路由中完成； -
CJS 兼容写法（如未启用 ESM）：若项目仍用 CommonJS，可改用：
const { OpenAI } = require('openai'); const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
? 总结：升级到 v4 后，只需一行导入 import OpenAI from 'openai'，再实例化调用即可。务必检查版本、隔离前后端逻辑、并遵循安全实践。官方最新文档始终以 OpenAI Platform Quickstart (Node.js) 为准。
