Google Gemini Python SDK模块导入问题解决方案

在Python项目中使用Google Gemini生成式AI功能时，开发者可能会遇到"ModuleNotFoundError: No module named 'google.generativeai'"的错误提示。这个问题通常发生在尝试导入旧版SDK时，而实际上应该使用新版SDK。

问题背景

Google最近对其生成式AI的Python SDK进行了重大更新，推出了专门为Gemini 2模型优化的新版SDK。旧版的google-generativeai包已被google-genai取代，这导致直接使用旧版导入语句时会报错。

解决方案

要正确使用Gemini 2模型，开发者应该：

1. 安装新版SDK包：

pip install google-genai

2. 在代码中使用正确的导入方式：

import google.genai as genai

3. 初始化客户端时使用新版API：

client = genai.Client(api_key="您的API密钥")
response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="需要生成的内容",
)

新旧版本区别

1. 包名称变化：从google-generativeai变为google-genai
2. 功能优化：新版SDK针对Gemini 2模型进行了专门优化
3. API接口：部分方法签名和参数有所调整

最佳实践建议

1. 对于新项目，直接使用google-genai包
2. 现有项目建议按照官方迁移指南进行升级
3. 注意API密钥的安全存储，不要直接硬编码在代码中
4. 使用虚拟环境管理项目依赖，避免包版本冲突

常见问题排查

如果仍然遇到导入错误，可以检查：

1. Python环境是否正确（使用python -V确认版本）
2. 是否在正确的虚拟环境中安装了包
3. 包是否成功安装（使用pip list检查）
4. 是否有拼写错误或路径问题

通过遵循这些指导原则，开发者可以顺利地在Python项目中使用Google Gemini的最新生成式AI功能，充分发挥Gemini 2模型的强大能力。