win11上python新手三大高频问题：未勾选add python to path导致命令不可识别；pip默认境外源超时或ssl错误，需配置清华镜像及trusted-host；vs code无法自动发现解释器，须手动指定python.exe路径并避免使用py.exe或pythonw.exe。
装Python本身不难，难的是PATH没配对、pip源卡住、VS Code找不到解释器——这三个问题占了Win11上Python新手报错的80%以上。
安装时必须勾选 Add Python to PATH
这是整个流程里唯一不可妥协的选项。不勾它，后续所有命令行操作都会报 python 不是内部或外部命令。
- 双击运行
python-3.12.5-amd64.exe后，第一屏就看到这个复选框，务必打勾 - 如果误点了
Install Now而没勾，别重装——直接进「设置 > 系统 > 高级系统设置 > 环境变量」，在系统变量Path里手动加一行，比如D:\Python312\和D:\Python312\Scripts\ - 勾了但依然无效？常见原因是安装时没用管理员权限，或者PATH长度超限（Win11默认限制2048字符），此时要运行安装包末尾的
Disable path length limit按钮
pip install 总是超时或报 SSL 错误
因为默认走境外源，国内直连大概率失败。不是网络问题，是源本身不可达。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 先升级 pip：
python -m pip install --upgrade pip - 再设清华镜像（永久生效）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 必须同步加信任主机，否则仍会 SSL 报错：
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”灰色按钮点不动，本质是它没扫描到你装的路径。
- 按
Ctrl+Shift+P，输Python: Select Interpreter，弹出列表后点右下角的Enter interpreter path... - 手动指向你的 Python 安装目录下的
python.exe，例如D:\Python312\python.exe - 如果点完没反应，关掉 VS Code 再打开，或者删掉项目根目录下的
.vscode/settings.json（里面可能存了错误路径） - 注意：不要选
py.exe或pythonw.exe，必须是带console输出能力的python.exe
最常被忽略的一点：Win11 默认启用 PowerShell 执行策略限制，如果你用 PowerShell 运行脚本失败，别急着改 Python 配置，先在管理员 PowerShell 里跑一遍 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。这和 Python 无关，但会拦住你后续所有自动化脚本。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
