PyCharm无法识别google.cloud引用但代码可执行的解决求助

问题场景 #

我使用Poetry搭配pyenv管理Python依赖，pyproject.toml配置如下：

[tool.poetry]
name = "hello-world"
version = "0.1.0"
description = "None"
authors = ["Hello <foo@bar.com>"]
readme = "README.md"
keywords = []

[tool.poetry.dependencies]
python = ">=3.9,<3.11"
google-cloud = "^0.34.0"
google-cloud-core = "^2.3.2" 
google-cloud-bigquery-datatransfer = "^3.7.1"
google-cloud-bigquery = "^3.3.2"
google-cloud-firestore = "^2.5.2"

[[tool.poetry.source]]
name = "ngt-pypi"
url = "link/to/private/package/abc-python/simple/"
default = false
secondary = true

[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"

已通过pyenv安装Python 3.9.6，执行以下命令完成依赖安装：

poetry config virtualenvs.in-project true
poetry install

确认虚拟环境中已安装最新版本的Google Cloud相关库，但编写代码时：

from google.cloud import bigquery

PyCharm编辑器提示找不到该引用，然而代码可正常执行且无报错。

解决步骤 #

• 核对PyCharm的Python解释器配置

  1. 打开File > Settings > Project: hello-world > Python Interpreter
  2. 点击右上角齿轮图标，选择Add
  3. 选择Virtualenv Environment，找到项目根目录下的.venv文件夹，选中其中的bin/python（Linux/macOS）或Scripts/python.exe（Windows）
  4. 确认后应用设置，等待PyCharm重新索引依赖

• 强制刷新依赖索引与缓存

  1. 打开右侧边栏的Python Packages面板，点击顶部刷新图标，等待索引完成
  2. 或执行File > Invalidate Caches...，选择Invalidate and Restart，重启后让PyCharm重新加载所有缓存

• 验证虚拟环境路径一致性
  执行命令查看Poetry虚拟环境路径：

  poetry env info
  

  确保PyCharm选中的解释器路径与输出中的Path字段完全一致。

• 手动添加库安装路径（若需）
  进入虚拟环境，执行命令查看google-cloud-bigquery的安装路径：

  pip show google-cloud-bigquery
  

  复制输出中的Location路径，在PyCharm的Python Interpreter设置中：

  1. 点击底部Show All...，选中当前解释器
  2. 点击Show paths for the selected interpreter，添加复制的路径并应用设置

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