Python代码运行正常但LSP提示导入无法解析（pyenv环境）

针对你遇到的代码能正常运行但LSP提示「import could not be resolved」的问题，可按以下步骤排查解决：

一、修复项目内部模块的导入提示 #

• 添加项目根目录到LSP的额外路径
  在编辑器的配置文件中指定项目根目录为Python额外路径，以VS Code为例，创建.vscode/settings.json并添加：

  {
    "python.analysis.extraPaths": ["${workspaceFolder}"]
  }
  

  其他编辑器（如Neovim使用pyright）需在对应LSP配置中添加项目根路径，确保LSP能识别image_batch_processor作为顶层包。

• 补全子包的__init__.py文件
  你的image_processing/utilities目录缺少__init__.py文件，补充一个空的__init__.py，让LSP将其识别为合法的Python子包。

二、修复第三方库（numpy、cv2）的导入提示 #

• 手动指定pyenv环境的解释器路径
  运行which python获取当前激活的pyenv环境解释器完整路径（例如~/.pyenv/versions/3.10.12/bin/python），在编辑器中手动选择该路径作为Python解释器，避免LSP误选其他环境。

• 确认依赖安装在当前pyenv环境
  先验证当前pip属于激活的pyenv环境：

  pyenv which pip
  

  然后用该pip重新安装依赖，确保包安装在当前环境的site-packages下：

  $(pyenv which pip) install numpy opencv-python
  

• 重启LSP服务
  在编辑器中执行重启语言服务器的命令（如VS Code按Ctrl+Shift+P选择「Python: Restart Language Server」），清除LSP的环境缓存，让它重新读取当前环境的依赖信息。

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