如何让PyCharm与VS Code的Pylint导入配置兼容？

问题背景 #

我使用Python 3.10开发项目，同时用PyCharm做运行调试、VS Code写代码，项目结构如下：

my_project_folder
├─ subfolder_1
├─ subfolder_2
├─ …
├─ __init__.py
└─ application.py

遇到两种导入语句的兼容问题：

• 用from subfolder_1 import func1, func2：PyCharm里运行正常，但VS Code会触发Pylint错误Unable to import 'subfolder_1'
• 换成from my_project_folder.subfolder_1 import func1, func2：VS Code里无错误，但PyCharm提示Unresolved reference 'my_project_folder'，项目无法运行

目前未给两款工具做特殊配置（比如虚拟环境），想调整配置让两种导入方式在两边都能正常使用。

统一兼容配置方案 #

1. 确保项目为标准Python包结构 #

确认my_project_folder和所有子文件夹（subfolder_1、subfolder_2等）下都有__init__.py文件（空文件即可），让Python将这些目录识别为合法包。

2. 配置VS Code，让Pylint正确识别项目路径 #

• 打开VS Code，按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Python: Select Interpreter，选择当前使用的Python 3.10解释器。
• 打开工作区的.vscode/settings.json，添加以下配置，将项目根目录加入Python路径：

{
    "python.analysis.extraPaths": [
        "${workspaceFolder}"
    ],
    "python.linting.pylintArgs": [
        "--init-hook",
        "import sys; sys.path.insert(0, '${workspaceFolder}')"
    ]
}

配置完成后，VS Code的Pylint就能正确识别两种导入方式，不会再报错。

3. 配置PyCharm，支持顶层包导入 #

• 右键点击my_project_folder，选择Mark Directory as -> Sources Root（这一步默认可能已完成，建议确认）。
• 若要让from my_project_folder.subfolder_1 import ...正常运行，将项目根目录的父目录加入Python路径：
  1. 点击File -> Settings -> Project: my_project_folder -> Python Interpreter
  2. 点击右上角齿轮图标，选择Show All
  3. 选中当前使用的解释器，点击Show paths for the selected interpreter
  4. 点击+号，添加my_project_folder所在的父目录（例如my_project_folder在D:/projects/下，就添加D:/projects/）
     配置后，PyCharm就能识别my_project_folder作为顶层包，两种导入方式都能正常运行调试。

临时替代方案（已验证有效） #

如果暂时不想调整路径配置，可以在VS Code中屏蔽Pylint的导入错误提示，操作如下：

• 打开工作区设置，找到Pylint Args，添加以下三个参数：
  • --disable=all
  • --enable=F,E,unreachable,duplicate-key,unnecessary-semicolon,global-variable-not-assigned,unused-variable,binary-op-exception,bad-format-string,anomalous-backslash-in-string,bad-open-mode
  • --disable=F0401
    设置后，真正错误的导入仍会被标记，不会影响代码错误识别。

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