VSCode中运行Python脚本无法跨文件导入函数该如何解决？

核心原因 #

这个问题完全是PyCharm和VSCode的默认运行逻辑差异导致的，和代码本身无关：

• PyCharm会自动将你打开的项目根目录加入Python的模块搜索路径sys.path，不管你在哪个子目录运行代码，都能正常识别项目内的其他模块。
• VSCode默认不会自动添加项目根目录到sys.path，运行代码时Python只会搜索两类路径：当前运行脚本所在的文件夹、终端当前工作目录。你在子文件夹内运行代码时，上层的项目根目录不在搜索列表里，就会出现导入失败；就算同目录脚本导入异常，大概率是你打开的VSCode工作区根目录不是项目根目录，导致路径匹配错误。
• 你添加__init__.py后示例能正常运行，是因为该文件会让Python将对应文件夹识别为可导入的标准包，一定程度上缓解了路径识别问题，但没有从根本解决搜索路径的配置差异。

推荐解决方法 #

• 每次打开项目时，直接用VSCode打开你的项目根目录文件夹（比如本次示例的F:\python\hello_world），不要打开上层文件夹作为工作区，避免路径混淆。
• 配置VSCode和PyCharm保持一致的运行逻辑：按F5选择Python interpreter后自动生成.vscode/launch.json配置文件，在配置中添加一行参数：

  "env": {"PYTHONPATH": "${workspaceFolder}"}
  

  配置完成后运行代码，会自动将当前工作区根目录加入Python搜索路径，完全匹配PyCharm的导包逻辑。
• 如果需要临时在深层子文件夹运行单脚本，可以在脚本开头手动添加上层根目录到搜索路径：

  import sys
  from pathlib import Path
  # 脚本在二级子目录就写2个parent，三级就写3个，以此类推
  sys.path.append(str(Path(__file__).parent.parent))
  

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