根本原因是path环境变量未正确配置：安装时未勾选“add python.exe to path”，或仅添加了python主目录而遗漏scripts子目录，导致cmd/powershell无法定位python.exe及pip等工具。
python 命令在 CMD 或 PowerShell 里报“不是内部或外部命令”，基本就是环境变量没配对——不是没加，就是加错位置、漏路径、或被权限/长度限制拦住。
安装时必须勾选 Add python.exe to PATH
这是唯一不可绕过的动作。双击 python-3.12.x-amd64.exe 后，第一屏就出现这个复选框，必须手动勾上。不勾，PATH 一条都不加，后续所有命令行操作都会失败。
常见误操作：
- 点了
Install Now跳过自定义页，直接错过勾选项 - 进了
Customize installation却只关注安装路径，忽略页面底部的勾选项 - 勾了但没用管理员权限运行安装包（尤其装到
C:\Program Files\下时）
pip 不可用？大概率漏了 Scripts 目录
python.exe 在主目录，pip、venv、pylint 等工具实际在 Scripts 子目录里。只加主目录，pip --version 必然失败。
手动补路径时，必须同时加入以下两个目录（以默认安装路径为例）：
C:\Users\<username>\AppData\Local\Programs\Python\Python312\</username>C:\Users\<username>\AppData\Local\Programs\Python\Python312\Scripts\</username>
注意：PATH 只接受目录，不能写成 C:\...\python.exe；末尾反斜杠可加可不加；不要加系统变量，优先改「用户变量」下的 Path。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
验证是否真生效，别信安装界面的“成功”提示
改完环境变量后，必须关掉所有已打开的终端（CMD / PowerShell / VS Code 终端），再新开一个窗口验证：
- 运行
where python，应只返回一条你刚装的 3.12 路径 - 运行
pip --version，输出中要带Python 3.12 - 运行
python -m venv testenv && .\testenv\Scripts\activate && python -c "print('ok')"，三步全通才算完整
如果 where python 返回多条，说明有旧版 Python 或 Microsoft Store 版本干扰，需清理用户 PATH 前面的冲突项。
PATH 超长、PowerShell 执行策略这些隐形障碍常被忽略
即使路径全对，也可能卡在更底层：
- Windows 默认
PATH长度上限 2048 字符 → 运行安装包末尾的Disable path length limit按钮，或启用LongPathsEnabled组策略 - PowerShell 默认执行策略为
Restricted→ 后续跑.ps1脚本会被拦，需在管理员 PowerShell 中运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - VS Code 找不到解释器 → 它不会自动扫描非默认路径，按
Ctrl+Shift+P输入Python: Select Interpreter，手动指向python.exe（不能选pythonw.exe或py.exe）
最常被忽略的一点：Win11 默认把新安装的程序路径加到用户 PATH，而不是系统 PATH。如果你装的是普通账户，又没勾 “Install for all users”，那其他账户或某些终端（比如从开始菜单启动的 PowerShell）可能根本看不到这个 PATH。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
