Windows 下：Python 3.11 稳妥安装与配置指南

一、 核心安装步骤（至关重要）

1. 下载正确版本

• 访问官网下载：Windows installer (64-bit)

• 推荐版本：Python 3.11.x（目前 AI 插件生态、深度学习库兼容性最完美的版本）

2. 图形界面安装必看（避坑关键点）

• 双击打开下载好的 .exe 安装包。

• 核心第一步：务必勾选最下方的 "Add python.exe to PATH"（如果不勾选，AI 工具在后台会报错找不到命令）。

• 点击下方进入 "Customize installation" (自定义安装)。

3. 可选特性（Optional Features）

• 保持默认，确保 pip（包管理器）被勾选，点击 Next。

4. 高级选项配置（Advanced Options 避坑）

• 务必勾选："Install Python 3.11 for all users"。

• 作用：勾选后，安装路径会自动变为干净的 C:\Program Files\Python311。能彻底避免因 Windows 用户名包含“空格”或“中文”导致 AI 插件运行报错的玄学问题。

• 点击 Install 开始安装。

5. 禁用路径长度限制（如有提示）

• 安装完成（Setup was successful）的界面如果出现 "Disable path length limit" 按钮，果断点击它。防止以后 AI 自动安装深层依赖包时因 Windows 路径超长而死锁。