系统未将python加入path导致“不是内部或外部命令”，需手动添加python安装目录（不含python.exe）到环境变量，并用新cmd验证；多版本共存时优先用py启动器管理。
cmd里直接运行python命令报“不是内部或外部命令”
说明系统没把Python加进环境变量PATH，Windows找不到python这个可执行程序。
- 先确认Python是否真的装了：去
C:Users{用户名}AppDataLocalProgramsPython或C:Python39这类路径下找有没有python.exe - 如果找到了，右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里双击
Path，新增一行，填入Python安装目录（比如C:Python311），**不要加python.exe** - 新开一个cmd窗口再试
python --version，能输出版本号才算成功 - 常见坑：装了多个Python（比如通过Microsoft Store装的、用pyenv装的、自己下载exe装的），它们的路径不同，且Store版默认不加PATH，优先检查
where python返回哪几个路径
双击.py文件一闪而退，看不到报错
Windows默认用pythonw.exe打开.py文件——它不弹命令行窗口，出错也没提示，纯黑盒。
- 临时解决：在文件所在目录按住
Shift右键 → “在此处打开 PowerShell 窗口”，然后输入python script.py - 永久改关联：管理员身份运行PowerShell，执行
associations.ps1脚本（需自行编写）不如直接改注册表；更稳妥的做法是右键.py文件 → “打开方式” → “选择其他应用” → 勾选“始终使用此应用打开.py文件” → 找到python.exe（不是pythonw.exe） - 注意：如果脚本依赖命令行参数或用户输入，双击永远不合适，必须走终端
VS Code里点三角形运行，却提示ModuleNotFoundError
VS Code默认用当前工作区根目录作为sys.path[0]，但你的import语句可能按项目结构写了相对路径，或依赖src/这种源码根目录。
- 先看左下角Python解释器路径是否正确：点击VS Code左下角蓝色条里的Python版本，确保选中的是你期望的环境（比如
venvScriptspython.exe） - 检查
launch.json里有没有配"cwd"（当前工作目录），没配就默认是打开的文件夹，不是.py文件所在目录 - 简单绕过：在代码开头加两行
import sys; sys.path.insert(0, "D:\myproject\src")，但这是权宜之计，长期应配pyproject.toml或__init__.py让包可导入 - 真实场景：用
pip install -e .把本地包安装为开发模式，比硬调sys.path更可靠
用py启动器比python更稳？
是的。py是Windows官方提供的Python启动器，自带多版本调度能力，而且默认就在PATH里（哪怕你没手动加Python路径）。
- 查所有已注册版本：
py -0（注意是数字0，不是字母o） - 指定版本运行：
py -3.9 script.py或py -3.11 script.py - 脚本第一行写
#! /usr/bin/env python3.10在Windows无效，但写#! py -3.10可以被py识别（需系统启用shebang支持，Win10 1903+默认开启） - 坑点：
py默认行为受py.ini影响，用户目录下的%USERPROFILE%py.ini可能覆盖全局策略，调试时建议先py -0p看实际调用路径
py -3.9，结果脚本里os.system("python xxx")调的却是3.11，版本不一致的bug就藏在这类细节里。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
