导入google.generativeai时遇ModuleNotFoundError模块缺失问题求助

问题概述 #

已安装google-generativeai及相关依赖包，但执行导入语句import google.generativeai as genai时，触发以下错误：

ModuleNotFoundError: No module named 'google'

已安装关键依赖 #

• google-ai-generativelanguage 0.6.15
• google-api-core 2.24.2
• google-api-python-client 2.165.0
• google-auth 2.38.0
• google-generativeai 0.8.4

环境信息 #

• Python版本：3.9
• 操作系统：macOS
• 完整已安装包列表：

已完成排查 #

1. 确认google-generativeai包已安装
2. 重新安装过所有依赖
3. 在干净脚本中测试导入，错误仍存在
4. 确认API密钥已正确设置

原因分析 #

该问题绝大多数是Python环境不一致导致：通过pip安装依赖的Python环境，和实际运行脚本的Python环境不是同一个，导致运行环境的site-packages目录中没有google相关包。macOS系统自带Python，加上手动安装的Python3、虚拟环境等，极易出现环境混淆。

解决步骤 #

1. 校验Python与pip的环境一致性 #

在终端执行以下命令，查看当前运行脚本的Python路径：

which python3

再查看pip对应的Python路径：

which pip3

如果两个路径不一致，说明pip安装的包不在当前运行的Python环境中。

2. 用对应环境的pip重新安装依赖 #

如果运行脚本使用的是python3，则用pip3执行安装：

pip3 install --upgrade google-generativeai google-ai-generativelanguage google-api-core google-auth

若使用虚拟环境，需先激活虚拟环境再执行上述命令。

3. 检查site-packages目录是否存在google包 #

执行以下命令获取当前Python环境的site-packages路径：

python3 -c "import site; print(site.getsitepackages())"

前往输出的路径，确认是否存在google文件夹。若不存在，说明依赖未安装到该环境中，需重新执行步骤2。

4. 使用虚拟环境隔离依赖（推荐） #

macOS系统自带的Python不建议用于第三方包安装，建议创建虚拟环境隔离依赖：

# 创建虚拟环境
python3 -m venv gemini-env
# 激活虚拟环境
source gemini-env/bin/activate

激活后，安装所有所需依赖：

pip install google-generativeai google-ai-generativelanguage google-api-core google-auth google-api-python-client

运行脚本时确保虚拟环境处于激活状态。

5. 验证导入是否成功 #

在终端执行以下命令，快速验证导入：

python3 -c "import google.generativeai as genai; print('导入成功')"

若输出导入成功，说明问题已解决，可正常运行目标脚本。

内容的提问来源于stack exchange，提问作者박지민