VSCode 2023年12月12日更新后Python模块导入异常求助

问题描述 #

过去一年多，我一直用以下代码解决Python导入自定义模块的问题：

sys.path.append(os.path.expanduser("~/sync/Coding/Templates"))

该目录下的Template.py文件，我通过以下方式调用自定义函数：

import Template as T
T.func_whatever() 

但VSCode更新后，无法识别Template.py里新增的任何函数，只能识别更新前的旧函数。我已经尝试修改settings.json，也参考过相关方案，但问题还是没解决。

解决步骤 #

• 清除工作区解释器缓存
  打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入Python: Clear Workspace Interpreter Cache执行，然后重启VSCode。

• 配置额外路径并确认解释器
  在settings.json里添加模块路径，确保和代码里的路径一致：

  "python.analysis.extraPaths": [
      "~/sync/Coding/Templates"
  ]
  

  同时通过命令面板Python: Select Interpreter，选择你运行代码时使用的Python环境，避免解释器不一致导致的缓存问题。

• 强制重新分析模块
  右键点击Template.py，选择Python: Analyze File，触发语言服务重新解析文件。如果没用，删除.vscode文件夹下的pyrightconfig.json（如果存在），重启VSCode让配置重新生成。

• 验证加载的模块路径
  在代码里添加打印语句，确认加载的是你修改后的文件：

  import Template as T
  print(T.__file__)
  

  如果输出的不是你更新的Template.py路径，说明有重名模块被优先加载，检查其他路径下是否有同名文件。

• 更新Python插件
  打开VSCode扩展面板，找到Python插件，安装最新版本后重启VSCode。

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