根本原因是环境变量未对齐或工作目录配置错误：Python解释器找不到是因PATH缺失路径，ModuleNotFoundError则多因VS Code默认cwd与代码导入上下文不一致，需修正PATH、launch.json的cwd、python.terminal.executeInFileDir设置或使用pip install -e .。
VS Code 找不到 python 命令，或运行时提示 ModuleNotFoundError、No module named 'xxx'，根本原因通常不是 Python 没装好，而是环境变量没对上——系统 PATH 里缺解释器路径，或者 VS Code 启动时的工作目录（cwd）和你代码期望的导入上下文不一致。
Python 解释器找不到：检查并补全系统 PATH
VS Code 启动时会读取系统环境变量 PATH 来发现可用的 Python 解释器。如果“选择解释器”列表为空，或命令面板里执行 Python: Select Interpreter 没反应，大概率是 python.exe（Windows）或 python3（macOS/Linux）不在 PATH 中。
- Windows：打开 CMD，运行
where python；若无输出，说明未加入 PATH。需手动把 Python 安装目录（如C:\Users\XXX\AppData\Local\Programs\Python\Python311）和Scripts子目录（如C:\Users\XXX\AppData\Local\Programs\Python\Python311\Scripts）都加进系统环境变量Path - macOS/Linux：终端运行
which python3，若无结果，编辑~/.zshrc或~/.bash_profile，追加export PATH="/usr/local/bin:$PATH"（路径按实际调整），然后source ~/.zshrc - 验证方式：关闭所有终端和 VS Code，重新打开 VS Code，再试一次
Python: Select Interpreter—— 此时应能列出本地安装的解释器
运行时报 No module named：cwd 配置错位
你在 test/main.py 里写 from envs.env1 import xxx，却报 No module named 'envs'，但 PyCharm 能跑通？这不是代码问题，是 VS Code 默认以工作区根目录为 cwd 启动解释器，而你的 import 是基于当前文件所在目录（test/）写的。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 用 F5 调试时：打开
.vscode/launch.json，确保配置含"cwd": "${fileDirname}"，而不是默认的"${workspaceFolder}" - 用右键「Run Python File in Terminal」时：快捷键
Ctrl+,打开设置，搜索python.terminal.executeInFileDir，勾选它 - 用 Code Runner 插件时：在
settings.json（全局或工作区）中添加"code-runner.executorMap": {"python": "cd $dir && python -u $fileName"}，或更稳妥地设"code-runner.runInTerminal": true并配合上面的executeInFileDir选项
PYTHONPATH 不生效：别靠手动 sys.path.append()
有人在代码开头写 sys.path.append('..') 或 sys.path.append(os.getcwd()) 来绕过导入失败，这看似有效，实则脆弱且不可移植——os.getcwd() 返回的是终端启动时的路径，不是文件所在路径；而且每次运行都要改代码，调试、CI、打包全崩。
立即学习“Python免费学习笔记（深入）”；
- 真正该做的是让 Python 解释器“天然知道”你的模块在哪：在项目根目录下建一个
myproject.pth文件，内容只有一行路径，比如D:\myproject\src，然后把这个.pth放进site-packages目录（虚拟环境里是.venv\Lib\site-packages\） - 更推荐做法：用虚拟环境 +
-e安装。在项目根目录（含setup.py或pyproject.toml）执行pip install -e .，这样所有子模块都能被直接 import，且与 VS Code 的cwd设置解耦 - 注意：
PYTHONPATH环境变量虽可用，但在 VS Code 的 launch.json 里必须显式传入，例如"env": {"PYTHONPATH": "${workspaceFolder}/src"}，否则不生效
最易被忽略的一点：VS Code 的 Python 插件会缓存解释器路径和环境变量，改完 PATH 或 launch.json 后，必须完全退出 VS Code（不只是关窗口），再重新打开，否则旧状态仍生效。
