必须下载Windows Installer(64-bit)并勾选“Add python.exe to PATH”，安装后需依次验证python --version、pip --version和python -m venv testenv，三者均成功才算安装完整。
直接装官方安装包并勾选“Add Python to PATH”就行，但很多人漏掉关键验证步骤，导致后续命令行报错 python 不是内部或外部命令。
下载时必须选“Windows Installer (64-bit)”而非“Embeddable zip file”
Embeddable 版本不带 pip、不写注册表、也不提供 python 命令入口，只适合嵌入式部署。日常开发请务必下载带 “Installer” 字样的 MSI 安装包（页面通常标为 Python 3.12.x Download for Windows）。
- 访问 python.org/downloads，滚动到底部找
Windows x86-64 executable installer - 不要点错成上方的
Windows embeddable package - 如果用 ARM64 设备（如 Surface Pro X），才选对应 ARM 版本，否则一律选 x86-64
安装过程中必须勾选 “Add python.exe to PATH”
这一步决定你能否在任意目录下直接运行 python 或 pip。MSI 安装向导第一页就有这个复选框，默认可能未勾选——尤其当你用“Customize installation”时容易忽略。
- 勾选后，安装器会自动把
C:\Users\<username>\AppData\Local\Programs\Python\Python312\</username>和Scripts子目录加进系统 PATH - 如果跳过此步，手动添加环境变量极易出错：比如只加了主目录却漏掉
Scripts，导致pip找不到 - 安装完成后重启终端（CMD/PowerShell/Terminal）才能生效，旧窗口不会自动加载新 PATH
验证是否真成功：别只跑 python --version
python --version 成功不代表 pip 可用，更不代表虚拟环境能创建。很多用户卡在后续 pip install 报错或 python -m venv myenv 失败，根源其实是安装不完整。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
立即学习“Python免费学习笔记（深入）”；
- 依次执行三行命令，全部返回版本号才算过关：
python --version-
pip --version（应显示 pip 版本 + Python 3.12 路径） python -m venv testenv && .\testenv\Scripts\activate && python -c "print('ok')"- 若第二步失败，说明
Scripts目录没进 PATH；若第三步报错‘venv’ module not found，可能是安装时没选“Install for all users”或权限受限
常见 PATH 冲突：已有旧版 Python 或第三方工具干扰
Windows 经常存在多个 Python 实例共存，比如通过 Microsoft Store 安装的 Python、Anaconda 自带的、或者旧版残留。它们可能把自己的路径塞进用户 PATH 前面，导致 python 指向错误版本。
- 运行
where python查看所有匹配路径，确认第一条是不是你刚装的 3.12 路径 - 如果显示
C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\python.exe</username>，那是 Store 版，需在设置 → 应用 → 隐私 > 应用权限 → “允许应用访问 Windows 应用程序” 关掉，或从 PATH 中删掉该条目 - 避免在系统 PATH 里硬编码
C:\Python312这类固定路径——用户目录下的 AppData 路径才是安装器实际写入的位置
真正麻烦的不是安装动作本身，而是 PATH 的隐式叠加和多版本优先级。哪怕勾选了“Add to PATH”，Windows 的环境变量继承机制也可能让旧路径盖过新路径。验证时多敲两行命令，比反复重装省时间得多。
