Visual Studio Code中Python跨目录导入时Ctrl+Click跳转失效求助

问题背景 #

目录结构：

Dev
 |-> MyModules
 |   |-> Module1
 |   |   |-> Module1.py
 |   |-> Module2
 |   |   |-> Module2.py
 |   |-> Module3
 |   |   |-> Module3.py
 |-> Project 1
 |   |-> ScriptA.py
 |   |-> ScriptB.py
 |-> Project 2
 |   |-> ScriptC.py
 |   |-> ScriptD.py

ScriptA.py代码：

from pathlib import Path
import sys
sys.path.append(Path(__file__).resolve().parents[1].__str__())

import MyModules.Module1.Module1 as M1
M1.Foo()

代码运行正常，但编辑器Ctrl+Click跳转M1或Foo()时提示未解析标签，无法使用跳转和自动补全功能，手动添加路径到工作区无效。

解决方案 #

针对VS Code #

1. 在Project 1目录下创建.vscode/settings.json文件（已存在则直接编辑）
2. 添加Python静态分析的额外路径配置，指向Dev目录（MyModules的父目录）：

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

配置后VS Code的Python分析器即可识别MyModules包，恢复跳转和自动补全功能。

针对PyCharm #

1. 右键点击MyModules目录，选择Mark Directory as -> Sources Root
2. 若当前仅打开Project 1作为单独项目，需先添加Dev目录为内容根：
   • 打开File -> Project Structure
   • 点击Add Content Root，选择Dev目录
   • 再次右键MyModules，标记为Sources Root

通用优化（可选） #

在MyModules及其子目录（如Module1）下添加空的__init__.py文件，将其转为标准Python包结构，可进一步提升编辑器静态分析的识别效率。

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