在Google Project IDX中配置Python版Firebase Functions遇错求助

核心问题分析 #

你遇到的ModuleNotFoundError: No module named 'numpy'原因如下：

• 手动安装的numpy仅存在本地虚拟环境，但Firebase部署时不会自动读取本地venv的依赖，必须将依赖写入requirements.txt文件
• 你使用了官方未支持的Python 3.12版本，可能导致环境依赖路径不匹配

分步解决方案 #

一、回到官方支持的Python版本（消除兼容隐患） #

1. 编辑项目根目录的dev.nix文件，将pkgs.python312修改为pkgs.python311（对应官方支持的Python 3.11版本）
2. 删除现有虚拟环境：

   rm -rf functions/venv
   

3. 进入functions目录，重新创建匹配版本的虚拟环境：

   cd functions
   python3.11 -m venv venv
   source venv/bin/activate
   

4. 重新初始化Firebase Functions依赖：

   firebase init functions
   

二、正确安装并同步第三方依赖 #

1. 在激活虚拟环境的状态下，安装numpy并将依赖写入requirements.txt：

   pip install numpy
   pip freeze > requirements.txt
   

   关键：Firebase部署时会读取requirements.txt自动安装所有依赖，必须执行pip freeze完成同步

2. 打开functions/requirements.txt，确认其中包含numpy相关条目（例如numpy==1.26.4）

三、重新部署函数 #

执行部署命令：

firebase deploy --only functions

额外注意事项 #

• 保持dev.nix中配置的Python版本和虚拟环境版本一致，避免环境不匹配导致的依赖路径问题
• 修改dev.nix后需重启Project IDX工作区，让新环境生效
• 严格遵循官方要求使用Python 3.10或3.11，非支持版本可能引发未知兼容问题

内容的提问来源于stack exchange，提问作者pb4now