Python 3.12安装后cmd报“不是内部或外部命令”主因是PATH未正确配置，安装时必须勾选“Add python.exe to PATH”，否则需手动添加安装目录及Scripts路径到系统环境变量。
装Python 3.12本身几秒钟就完事，真正卡住你的从来不是下载或点击安装，而是python命令在cmd里报“不是内部或外部命令”——这90%以上是因为PATH没配对，或者配了但路径不全、顺序错、权限被拦。
安装时必须勾选 Add python.exe to PATH
这是唯一不可绕过的动作。双击python-3.12.5-amd64.exe后，第一屏就出现这个复选框，必须打勾。不勾，后续所有命令行操作都失效。
- 如果误点了
Install Now跳过这步，别重装——直接进「设置 > 系统 > 高级系统设置 > 环境变量」，在系统变量Path里手动加两行：D:\Python312\和D:\Python312\Scripts\（路径以你实际安装位置为准） - 勾了但
python --version仍失败？常见原因：安装没用管理员权限，或Windows PATH长度超限（默认2048字符），此时需运行安装包末尾的Disable path length limit按钮 - Win11默认启用PowerShell执行策略限制，如果你之后用PowerShell跑脚本失败，先在管理员PowerShell里执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser——这不是Python问题，但会拦住你下一步
pip install 总是超时或报 SSLError
不是你网络差，是pip默认源https://pypi.org/simple/在国内直连基本不可达。SSL错误本质是证书验证失败，只靠换源不够，必须同步加信任主机。
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 先升级pip：
python -m pip install --upgrade pip - 设清华镜像（永久生效）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 必须加信任：
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn - 验证是否生效：
pip config list应输出两行；再试pip install requests，几秒内完成即成功
VS Code 找不到 Python 解释器
即使python --version能跑，VS Code 仍可能卡在“Select Python Interpreter”灰色按钮上——它压根没扫描到你装的路径，尤其当你装在非默认位置时。
立即学习“Python免费学习笔记（深入）”；
- 按
Ctrl+Shift+P，输Python: Select Interpreter，弹出列表后点右下角Enter interpreter path - 手动指向
python.exe，例如：D:\Python312\python.exe（注意：不能选py.exe或pythonw.exe，它们不带console输出能力） - 如果点完没反应，关掉VS Code再打开；或删掉项目根目录下的
.vscode/settings.json（里面可能存了错误路径）
最容易被忽略的一点：Win11默认把新安装的程序路径加到用户PATH，而不是系统PATH。如果你用的是普通账户，又没勾“Install for all users”，那其他账户或某些终端（比如从开始菜单启动的PowerShell）可能根本看不到这个PATH。确认PATH生效，永远以cmd里能跑通python和pip为唯一标准，别信安装界面的“成功”提示。
