vscode中python模块导入失败主因是sys.path未包含项目路径，需通过.env文件设pythonpath、launch.json配env或settings.json改终端环境变量解决，并重启窗口生效。
VSCode里Python模块导入失败，90%是因为sys.path没包含你的项目路径——不是代码写错了，是解释器根本没去你放模块的地方找。
为什么调试时能跑、Ctrl+F5却报ModuleNotFoundError
VSCode调试（F5）和终端运行（python xxx.py）用的是两套sys.path初始化逻辑。调试器默认不把项目根目录加进搜索路径，只认launch.json里显式配置的cwd或env。终端里你手动cd进项目再跑，当前目录自动入sys.path；但调试器不会替你做这一步。
- 调试启动时，
sys.path[0]通常是launch.json中cwd指定的目录，若没配，默认是VSCode打开的文件所在目录，未必是项目根目录 - 终端执行时，Python自动把脚本所在目录塞进
sys.path[0]，所以同一行import mypkg在终端能过，调试就挂 - 验证方法：在出错文件开头加
import sys; print(sys.path)，对比终端输出和调试器输出的前几项
python.analysis.extraPaths只影响Pylance提示，不影响实际运行
这个配置项只告诉VSCode的Python语言服务器（Pylance）：“这些路径下的模块也参与类型推导和补全”，但它完全不改变Python解释器本身的sys.path。即使你写了"python.analysis.extraPaths": ["${workspaceFolder}/src"]，运行时照样找不到src里的模块。
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
- 适用场景：代码提示、跳转、悬停文档正常了，但
ImportError还在 → 说明这是分析路径问题，不是运行路径问题 - 别把它当万能解：它不能解决
ModuleNotFoundError，只能解决“VSCode标红但代码其实能跑”的情况 - 路径写法要绝对：用
${workspaceFolder}变量安全，手写路径注意Windows用\或正斜杠，Mac/Linux用/，避免硬编码
真正生效的三种运行时路径配置方式
让Python解释器自己认得你的模块，必须动sys.path或环境变量。以下三个方案按优先级排序，选一个就行：
- 最稳：
.env文件 +PYTHONPATH。在项目根目录建.env，内容写PYTHONPATH=${workspaceFolder}（Windows下用分号;分隔多个路径）。VSCode Python插件会自动加载它，且对终端、调试、测试全部生效 - 最灵活：
launch.json里配env。在.vscode/launch.json的配置项中加"env": {"PYTHONPATH": "${workspaceFolder}"}。只影响调试，但可为不同配置设不同路径 - 最直接：改
settings.json的终端环境。在工作区.vscode/settings.json里加"terminal.integrated.env.windows": {"PYTHONPATH": "${workspaceFolder}"}（Linux/macOS换对应键名）。只影响集成终端，适合习惯终端跑命令的人
别踩的坑：__init__.py 和相对导入不是银弹
很多人以为只要每个目录放个空__init__.py，再用from ..subpackage import module就能绕过路径问题——这仅在包内相对导入有效，且要求你以-m方式运行（如python -m mypackage.main），而VSCode默认不是这么启动的。
- VSCode调试默认执行
python /full/path/to/file.py，不是-m模式，此时相对导入直接报SystemError: Parent module '' not loaded -
__init__.py只让目录变成包，不改变sys.path；它解决的是“能否被当作包导入”，不是“解释器去哪找” - 如果项目结构是
project/src/utils.py和project/tests/test_utils.py，想在test_utils.py里import utils，光靠__init__.py没用，必须把src加进PYTHONPATH或sys.path
路径问题本质是环境问题，不是语法问题。盯住sys.path输出，看Python到底在哪些地方找，比反复改import语句高效得多。每次改完配置，务必重启VSCode窗口或重载窗口（Ctrl+Shift+P → “Developer: Reload Window”），否则缓存可能让你白调半天。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
