VSCode怎么解决Python中import自己写的同级目录下模块报错找不到的问题-VSCode-PHP中文网

直接运行 python main.py 时同目录导入失败，是因为 Python 只将 main.py 所在目录加入 sys.path，而 VS Code 终端默认 cwd 是项目根目录而非文件所在目录；解决方法包括启用 python.terminal.executeInFileDir 设置、使用 python -m 模式运行或避免硬编码修改 sys.path。

vscode怎么解决python中import自己写的同级目录下模块报错找不到的问题

直接运行 python main.py 时同目录导入失败，不是代码写错了，而是 Python 解释器根本没把当前文件所在目录加进 sys.path —— 它只认你“怎么启动”的方式，不认你“文件放在哪”。

为什么 `from xxx import yyy` 在 VS Code 里报 `ModuleNotFoundError`

VS Code 默认用当前工作区根目录作为终端启动路径（cwd），但你的 main.py 和 test_file.py 可能都在 src/ 子目录下。此时解释器搜索路径里没有 src/，自然找不到同级的 test_file.py。

运行 python main.py 时，Python 只把 main.py 所在目录加入 sys.path —— 但 VS Code 的终端默认 cwd 是项目根目录，不是文件所在目录
from .test_file import xxx 是相对导入，只能在包内通过 python -m 方式运行才合法；直接执行会触发 SystemError: Parent module '' not loaded
Pylance 报红（如 Import "test_file" could not be resolved）往往和运行时错误不同源：它按静态路径推导，不执行代码，也不读 sys.path 动态变化

让 VS Code 终端真正“站在文件旁边”运行

这是最轻量、见效最快的修复，适用于单脚本调试或结构简单的项目。

打开 VS Code 设置（Ctrl+, 或 Cmd+,），搜索 python.terminal.executeInFileDir，勾选它
或者在 .vscode/settings.json 中手动加一行："python.terminal.executeInFileDir": true
这样右键「Run Python File in Terminal」时，终端会自动 cd 到 main.py 所在目录再执行，sys.path[0] 就是该目录，同级 import test_file 立刻生效
注意：此设置不影响 F5 调试，调试需另配 launch.json 中的 "cwd": "${fileDirname}"

用 `python -m` 模式运行（推荐长期项目）

这才是符合 Python 包语义的正解，尤其当你有 __init__.py 和多层结构时。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

确保你的目录是合法包：在 src/ 下放一个空的 __init__.py 文件
不要双击或直接 python src/main.py，而是在项目根目录下执行：python -m src.main
此时 src/ 被视为顶层包，main.py 中可用 from .test_file import Rock（相对导入）或 from test_file import Rock（同级导入）
VS Code 中可通过配置 launch.json 的 "module" 字段实现一键调试："module": "src.main"