一、嵌入式 Python 是什么?
就是免安装、解压即用的最小版 Python,体积小、干净,但默认不带 pip、不带环境变量、不带脚本目录,需要手动配置。
二、完整配置步骤(必做)
1. 解压文件
把下载的
python-3.x.x-embed-amd64.zip 解压到一个固定目录,例如:
plaintext
D:\PythonEmbed
不要放在中文路径、不要放在桌面、不要移动文件夹!
2. 开启 pip 功能(最关键!)
嵌入式版默认禁用 pip,必须手动开启:
- 进入解压目录
- 找到文件:python3x._pth(例如 python311._pth)
- 用记事本打开
- 取消注释这一行(删掉前面的 #)
plaintext
#import site
改成:
plaintext
import site
保存关闭。
3. 安装 pip(嵌入式版默认没有)
打开 CMD,cd 进入你的解压目录:
cmd
D: cd D:\PythonEmbed
然后执行安装 pip 命令:
cmd
python -m ensurepip
成功后会显示:
plaintext
Successfully installed pip-xx.x setuptools-xx.x
4. 配置系统环境变量(让全局能调用 python、pip)
步骤 A:添加 Python 主目录
- 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
- 在 系统变量 → Path 里点击 新建
- 填入你的解压路径,例如:
plaintext
D:\PythonEmbed
步骤 B:添加 Scripts 目录(pip 所在目录)
再新建一条:
plaintext
D:\PythonEmbed\Scripts
最终 Path 里必须有这两条:
plaintext
D:\PythonEmbed D:\PythonEmbed\Scripts
5. 测试是否配置成功
关闭所有 CMD,重新打开一个新 CMD:
cmd
python --version pip --version
能显示版本号 = 配置成功!
三、安装包(如 tccli)
cmd
pip install tccli -i https://pypi.tuna.tsinghua.edu.cn/simple
四、嵌入式 Python 常见坑(必看)
- 不能随便移动文件夹,否则全部失效
- 不能和安装版 Python 混用,容易冲突
- 部分库不支持嵌入式版(极少)
- 升级 pip 用这个命令:
python -m pip install --upgrade pip
五、极简总结(你只需要记这 4 步)
- 解压到固定英文路径
-
修改
python3x._pth开启import site -
执行
python -m ensurepip装 pip - 把主目录 + Scripts 目录加入 Path
