跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

Python 便携版配置与使用教程

Python 便携版基于官方嵌入式版本构建，无需依赖系统 Python 环境。核心步骤包括解压 embeddable package，修改 _pth 配置文件启用标准库与第三方包目录，并通过 get-pip.py 安装 pip。通过指定 python.exe 路径或配置启动脚本，可实现独立运行，避免污染系统环境，适用于 AI 工具开发及 GUI 程序分发。

星辰大海发布于 2026/2/24更新于 2026/10/24112 浏览

一、什么是 Python 便携版（Embedded Python）

核心定义

Python Embedded = 官方提供的'最小运行时 Python'

特点：

  • ✅ 不依赖系统 Python
  • ✅ 不写注册表
  • ✅ 不污染系统
  • ❌ 默认 锁死（不能 pip / 不能 site-packages）

📌 ComfyUI、Blender、很多商业软件都用这套

Embedded Python ≠ 普通 Python

项目普通 PythonEmbedded Python
Lib 目录默认存在❌ 默认没有
pip自带❌ 没有
ensurepip有❌ 没有
site-packages自动❌ 禁用
目标开发嵌入/便携

二、下载 Python 便携版（正确版本）

1️⃣ 下载地址（官方）

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

选择：

Python 3.10.x → Windows → embeddable package (64-bit)

文件名类似：

python-3.10.13-embed-amd64.zip

💡 推荐 Python 3.10，AI / PyTorch / Qt 生态最稳，ComfyUI 也用 3.10

2️⃣ 解压后的'正常结构'（别慌）

python_embed/
├─ python.exe
├─ python310.dll
├─ python310.zip ← 标准库在这里
├─ python310._pth ← 最重要的控制文件
├─ vcruntime140.dll
└─ ...

✅ 没有 Lib/ 是完全正常的 ✅ 标准库在 python310.zip

三、Embedded Python 的'解锁原理'（一定要理解）

默认状态（锁死）

Embedded Python 默认：

  • ❌ 不加载 Lib
  • ❌ 不加载 site-packages
  • ❌ 不允许 pip

这是通过 python310._pth 控制的。

_pth 是什么？

它是：

Python 启动时的'白名单路径表'

  • 只加载你写进去的路径
  • 绝不偷偷读系统环境

📌 这就是它'便携 + 隔离'的核心

四、配置 Embedded Python（最关键部分）

✅ Step 1：手动创建目录（必须）

在 python_embed 目录下，新建：

python_embed/
├─ Lib/
│ └─ site-packages/

👉 Python 不会帮你建，你要自己建

✅ Step 2：编辑 python310._pth

打开：

python_embed\python310._pth

把内容 完全改成下面这样（照抄）：

python310.zip . Lib Lib\site-packages import site
每一行的意义
行作用
python310.zip标准库
.当前目录
Lib启用 Lib
Lib\site-packages第三方库
import site解锁 pip / site-packages

⚠️ 没有 import site = 一切白搭

五、给 Embedded Python 安装 pip（正确方式）

❌ 为什么 ensurepip 不存在？

Embedded Python 官方移除了：

  • ensurepip
  • venv

👉 所以你看到：

No module named ensurepip

是 正常现象

✅ 正确解法：get-pip.py（官方方案）

Step 1：下载 get-pip.py

地址：

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

放到：

python_embed\get-pip.py
Step 2：用'便携 python.exe'运行
cd D:\示例路径\python_embed
.\\python.exe get-pip.py

成功后会安装：

  • pip
  • setuptools
  • wheel

到：

python_embed\Lib\site-packages\
Step 3：验证 pip
.\\python.exe -m pip --version

输出示例：

pip 24.x from D:\示例路径\python_embed\Lib\site-packages\pip

✅ 说明成功

六、在便携 Python 中安装第三方库（正确姿势）

⚠️ 永远用你的 python.exe

.\\python.exe -m pip install faster-whisper 

.\\python.exe -m pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu121

❌ 不要用：

pip install xxx

七、如何'确保不用系统 Python'（核心技巧）

方法一：始终用绝对路径

D:\示例路径\python_embed\python.exe app\main.py

方法二：启动脚本（推荐）

run.bat（标准写法）
@echo off
set BASEDIR=%~dp0
set PYTHONHOME=%BASEDIR%python_embed
set PYTHONNOUSERSITE=1
set PATH=%BASEDIR%python_embed;%BASEDIR%python_embed\Scripts;%PATH%
"%BASEDIR%python_embed\python.exe" app\main.py
pause

自检（一定要做）

在 main.py 里：

import sys
print(sys.executable)

必须输出：

D:\示例路径\python_embed\python.exe

八、为什么'没有 Lib 也能 import os/json？'

因为：

  • 标准库在 python310.zip
  • Python 会自动从 zip 里加载

📌 这是 Embedded Python 的设计亮点

九、推荐的'便携 AI 项目结构'（对标 ComfyUI）

项目根目录/
├─ python_embed/
│ ├─ python.exe
│ ├─ python310.zip
│ ├─ python310._pth
│ └─ Lib/
│   └─ site-packages/
├─ ffmpeg/
│ └─ ffmpeg.exe
├─ app/
│ ├─ main.py
│ ├─ gui.py
│ └─ asr_engine.py
├─ run.bat
└─ README.md

十、发布前'自检清单'（非常重要）

  • sys.executable 指向便携 python
  • 删除系统 Python，程序仍能跑
  • pip 安装的库都在 Lib/site-packages
  • _pth 中有 import site

目录

  1. 一、什么是 Python 便携版（Embedded Python）
  2. 核心定义
  3. Embedded Python ≠ 普通 Python
  4. 二、下载 Python 便携版（正确版本）
  5. 1️⃣ 下载地址（官方）
  6. 2️⃣ 解压后的“正常结构”（别慌）
  7. 三、Embedded Python 的“解锁原理”（一定要理解）
  8. 默认状态（锁死）
  9. _pth 是什么？
  10. 四、配置 Embedded Python（最关键部分）
  11. ✅ Step 1：手动创建目录（必须）
  12. ✅ Step 2：编辑 python310._pth
  13. 每一行的意义
  14. 五、给 Embedded Python 安装 pip（正确方式）
  15. ❌ 为什么 ensurepip 不存在？
  16. ✅ 正确解法：get-pip.py（官方方案）
  17. Step 1：下载 get-pip.py
  18. Step 2：用“便携 python.exe”运行
  19. Step 3：验证 pip
  20. 六、在便携 Python 中安装第三方库（正确姿势）
  21. 七、如何“确保不用系统 Python”（核心技巧）
  22. 方法一：始终用绝对路径
  23. 方法二：启动脚本（推荐）
  24. run.bat（标准写法）
  25. 自检（一定要做）
  26. 八、为什么“没有 Lib 也能 import os/json？”
  27. 九、推荐的“便携 AI 项目结构”（对标 ComfyUI）
  28. 十、发布前“自检清单”（非常重要）

更多推荐文章

查看全部
  • 前端调用 AI 接口全流程实战：从配置到流式响应
  • DeepSeek 在主流云电脑平台的部署与性能对比评测
  • Spring Boot 响应式 Web 与传统 MVC 原理及适用场景对比
  • 2020 年信奥赛 C++ 提高组 CSP-S 初赛真题：完善程序第 2 题
  • 双指针算法详解与经典题目实战
  • Vue 3 前端调试与开发指南
  • Unreal Engine 5 中 VRM4U 插件使用指南与性能优化
  • Jupyter+Docker+cpolar 实现远程访问
  • 鸿蒙webview开发中web内部网络请求访问资源跨域问题，客户端解决方案
  • GitHub Copilot 学生认证与使用指南
  • Ghidra 开源逆向分析工具详解
  • 渐进式AIGC系统：支持Nano-Banana-2绘画、VEO3视频生成及Agent智能体
  • AVL 树原理及 C++ 代码实现
  • Git SSH 公钥认证失败 Permission denied (publickey) 解决方法
  • 7 款高颜值 Linux 发行版推荐
  • AI 编程工具深度对比：Cursor、Copilot、Trae 与 Claude Code
  • Git 分布式版本控制系统的安装与使用
  • 大疆测试岗实习面试全流程复盘
  • llama.cpp 量化模型部署实战：从模型转换到 API 服务
  • Ansible 批量部署 Nginx 实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online