嵌入式 Python 搭建笔记

AI 爆发之后，每天都在各种 Vibe Coding。对我来说，嵌入式 Python 比直接安装版、uv、Miniconda、Anaconda 更轻、更干净，也更适合手动控制环境。

• 不污染系统环境
• 安装位置可完全自定义
• 单机手动维护
• 临时项目、AI 工具链、脚本型开发场景

1. 下载 embeddable package

进入 Python Windows 下载页：

https://www.python.org/downloads/windows/

下载对应版本的 Windows embeddable package。

2. 修改 python312._pth

解压后，编辑对应版本的 _pth 文件，取消 site 相关注释。

# Uncomment to run site.main() automatically
import site

作用：启用 site，让 Python 能正常识别 site-packages。

3. 手动创建目录

在解压目录下手动创建：

Python312-embed\Lib\site-packages

没有这个目录时，后续安装的包无法按常规方式落盘。

4. 安装 pip

下载 get-pip.py 到 Python 解压目录：

https://bootstrap.pypa.io/get-pip.py

执行：

.\python.exe get-pip.py
.\python.exe -m pip --version

确认 pip 安装成功。

VSCode 配置

例如将嵌入式 Python 放在：

E:\DevTools\python-3.12.10

然后在项目的 .vscode/settings.json 中加入：

{
  "python.defaultInterpreterPath": "e:\\DevTools\\python-3.12.10\\python.exe",
  "terminal.integrated.env.windows": {
    "PATH": "e:\\DevTools\\python-3.12.10;e:\\DevTools\\python-3.12.10\\Scripts;${env:PATH}"
  }
}

作用：
- python.defaultInterpreterPath：让 VSCode 使用指定的嵌入式 Python
- terminal.integrated.env.windows.PATH：让项目终端优先使用这套 Python 和对应的 Scripts