如何在VSCode中复刻PyCharm的模块导入与文件路径访问逻辑

1. 确保模块导入基于项目根目录 #

• 在VSCode的settings.json中，将项目根目录添加到Python分析路径：

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

• 若通过调试模式运行代码，在.vscode/launch.json里配置PYTHONPATH，把项目根目录纳入模块搜索路径：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Current File",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "env": {
                  "PYTHONPATH": "${workspaceFolder}"
              },
              "console": "integratedTerminal"
          }
      ]
  }
  

  这样无论运行哪个文件，Python都会将项目根目录作为模块搜索路径的一部分，和PyCharm的模块导入逻辑对齐。

2. 让文件打开路径基于调用脚本所在目录 #

不要依赖VSCode的工作目录设置，而是在代码中动态获取当前脚本的绝对路径，再拼接目标文件路径。示例代码：

import os

# 获取当前脚本所在的绝对目录
current_script_dir = os.path.dirname(os.path.abspath(__file__))
# 拼接目标文件的完整路径
target_file_path = os.path.join(current_script_dir, 'somepath.txt')
# 打开文件
with open(target_file_path, 'r') as f:
    content = f.read()

这种写法不依赖IDE的工作目录配置，在PyCharm或VSCode中运行都能精准定位文件，比单纯依赖IDE设置更可靠。

为什么之前的设置无法满足需求？ #

python.terminal.executeInFileDir是控制终端运行时的工作目录：设为true时，工作目录切换为当前脚本所在目录，此时模块导入会因为sys.path中缺少项目根目录而失败；设为false时工作目录是项目根，open()的路径就会基于根目录而非脚本目录。所以必须分开处理模块导入的路径配置和文件打开的路径逻辑，不能依赖单一的工作目录设置。

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