VS Code无法识别Python相对/绝对导入但PyCharm可识别的问题

核心原因 #

PyCharm会自动将项目根目录（即ReskinRefactor文件夹的上级目录）加入Python的sys.path，而VS Code默认不会自动配置这一点，导致Python无法识别ReskinRefactor作为顶级包。

解决方案（不依赖IDE） #

1. 以模块方式运行脚本

如果playeground.py是包的一部分（目录下存在__init__.py），不要直接运行该文件，而是在项目根目录（ReskinRefactor的上级目录）执行：

python -m ReskinRefactor.test_files.Accounts.playeground

这种方式会让Python以包层级加载模块，自动识别正确的导入路径，同时支持相对导入。比如在playeground.py中可以这样写：

# 从ReskinRefactor.handlers导入模块，相对路径往上两级（Accounts → test_files → ReskinRefactor）
from ....handlers import driver_handler

2. 手动添加项目路径到sys.path

在需要导入模块的脚本开头（比如playeground.py）添加代码，动态将项目根目录加入sys.path：

import sys
from pathlib import Path

# 获取ReskinRefactor文件夹的上级目录（即项目工作区目录）
project_root = Path(__file__).resolve().parents[2]
sys.path.append(str(project_root))

# 现在可以正常使用绝对导入
from ReskinRefactor.handlers import driver_handler

Path(__file__).resolve().parents[2]的含义：__file__是当前脚本的路径，resolve()转为绝对路径，parents[2]表示往上两级目录（从Accounts到test_files再到ReskinRefactor的上级目录）。

3. 配置VS Code的工作区与运行环境

• 打开VS Code时，选择ReskinRefactor的上级目录作为工作区，而非单独打开ReskinRefactor或Accounts目录。
• 调整VS Code的Python运行配置：在.vscode/launch.json中添加cwd字段指定项目根目录，或确保env包含正确的PYTHONPATH：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Playground",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "cwd": "${workspaceFolder}",
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

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