Windows离线安装Python 3：嵌入式包部署与pip配置指南

在企业隔离内网、保密机房、工控机以及安全合规严苛的专用服务器环境中，Windows宿主机通常无法直接访问公网。常规的在线安装程序（Web Installer）与依赖注册表的标准安装包不仅难以在此类网络受限机器上正常安装，而且可能在卸载与系统升级时引发权限或注册表冲突。Python官方提供的“Windows embeddable package”（嵌入式免安装包）是一个体积仅有十几兆字节、绿色便携且不污染系统环境的独立发行版。本文将详细讲解如何在无网络连接的Windows系统中部署Python 3嵌入式包、解除其环境隔离限制、离线安装并配置pip包管理器，以及完成第三方依赖库的本地分发与安装。

一、方案选型与环境准备

Python官方为Windows平台提供了两种主流发布形态：常规安装版（Windows installer）与嵌入式包（Windows embeddable package）。了解两者的设计差异有助于合理规划离线运行架构。

由于嵌入式包默认设计用于被C/C++宿主程序内嵌调用，它在默认情况下禁用了外部包查找机制，并且未内置pip工具。因此，在离线部署前，需要在具有公网访问权限的联机机器上提前下载好所需的基础介质。

离线资源收集清单

在联机机器上下载以下文件并存入U盘或内网共享目录中（以Python 3.11.9 64位为例）：

1. 嵌入式核心压缩包：从Python官网下载 python-3.11.9-embed-amd64.zip。
2. Visual C++ 运行时依赖：嵌入式包依赖 vcruntime140.dll 及相关运行时。若离线宿主机为纯净新装系统，需准备微软官方 VC_redist.x64.exe（Visual C++ 2015-2022 Redistributable）。
3. pip官方引导脚本：访问 https://bootstrap.pypa.io/get-pip.py 下载独立的安装引导脚本。
4. pip及基础轮子包（Wheel）：在联机机器的终端中执行以下下载命令，将pip与其依赖的离线wheel文件保存至本地目录：

   pip download pip setuptools wheel -d ./pip_assets

二、解压部署与运行前置校验

将上述文件安全拷贝至离线宿主机后，首先选定一个干净、无特殊字符且无空格的固定路径进行解压。推荐使用如 C:\tools\python-3.11.9-embed 或 D:\runtime\python311 等规范路径。严禁解压到带有中文、空格或特殊符号的路径下（例如 C:\Program Files (x86)\ 或 C:\Users\张三\Desktop\），这会导致后续pip生成批处理脚本及路径转义时解析失败。

第一步：解压并验证解释器可执行性

在离线机器的命令提示符（CMD）或PowerShell中切换至解压目录，运行基础命令：

cd C:\tools\python-3.11.9-embed
python.exe -V

如果控制台能够正常输出 Python 3.11.9，说明解释器基本二进制加载正常。如果系统弹出弹窗报错：由于找不到 VCRUNTIME140.dll，无法继续执行代码，这表明当前Windows系统缺失C++运行库。此时须双击执行之前准备好的 VC_redist.x64.exe 安装补丁包；或者在具备合规授权的前提下，将 vcruntime140.dll 及 vcruntime140_1.dll 直接拷贝到 python.exe 所在的根目录下。

三、核心关键：修改 ._pth 文件以启用扩展包

直接在刚解压的嵌入式包中运行 pip 安装脚本必定会报错。这是因为嵌入式包在设计之初就默认执行严格的环境隔离。在解压目录下存在一个以小版本号命名的文件，如 python311._pth（若部署Python 3.10则为 python310._pth）。该文件决定了Python启动时的 sys.path 模块检索路径列表。

使用文本编辑器（如记事本、VS Code或Notepad++）打开该 python3xx._pth 文件，完成以下两项调整：

1. 将 #import site 前面的井号 # 彻底删除，使其变为单独一行的 import site。
2. 在文件中追加一行 Lib/site-packages（或者直接写 site-packages），以确保标准结构下的第三方库目录能够被解析。

修改后的完整 python311._pth 文件内容应当如下所示：

python311.zip
.
Lib/site-packages
import site

保存文件。此时Python嵌入式环境已解除包搜索隔离，具备了载入标准包管理器及后续所有扩展轮子包的底层基础。

四、离线引导与安装 pip 包管理器

完成 ._pth 文件修改后，即可在离线环境中通过 get-pip.py 脚本将 pip、setuptools 与 wheel 注入到嵌入式环境中。为了防止 get-pip.py 尝试连接公网 PyPI 镜像源导致连接超时挂起，必须指定 --no-index 以及存放本地轮子文件的目录 --find-links。

离线执行 pip 注入命令

假设我们把下载好的 get-pip.py 和 pip_assets 目录存放在 C:\tools\offline_cache 目录下，打开命令提示符，执行以下指令：

cd C:\tools\python-3.11.9-embed

python.exe C:\tools\offline_cache\get-pip.py --no-index --find-links=C:\tools\offline_cache\pip_assets

命令行执行后，控制台将输出类似以下的处理记录：

Looking in links: C:\tools\offline_cache\pip_assets
Processing c:\tools\offline_cache\pip_assets\pip-24.0-py3-none-any.whl
Processing c:\tools\offline_cache\pip_assets\setuptools-69.5.1-py3-none-any.whl
Processing c:\tools\offline_cache\pip_assets\wheel-0.43.0-py3-none-any.whl
Installing collected packages: wheel, setuptools, pip
Successfully installed pip-24.0 setuptools-69.5.1 wheel-0.43.0

安装完成后，检查当前目录，可以看到系统已经自动生成了两个重要的新目录：

• Lib\site-packages\：存放 pip、setuptools、wheel 源代码及相关 .dist-info 元数据文件。
• Scripts\：存放 pip.exe、pip3.exe 等启动器二进制脚本。

验证 pip 与模块检索完整性

在当前目录下运行以下命令，验证 pip 是否能够正常自省并列出已安装的包：

python.exe -m pip list

正确执行后，应返回包含 pip、setuptools 与 wheel 的版本表格。同时，可运行一行 Python 表达式检查 site 模块导出的包路径：

python.exe -c "import site; print(site.getsitepackages())"

输出结果中必须明确包含当前解压目录以及 Lib\site-packages 路径。如果能够打印出上述路径，说明整个嵌入式环境的扩展机制已被成功打通。

五、离线安装业务依赖与持久化配置

有了可工作的 pip 之后，后续各类业务扩展包（如 requests、pandas、flask、cryptography 等）的离线安装将遵循标准化的轮子包机制。

1. 依赖包离线全量抓取技巧

在联机机器上，如果直接通过 pip download requests 下载，可能只能抓取当前机器适用的包。为确保下载的 wheel 完全适用于离线宿主机（Windows 64位、特定Python小版本号），建议使用严格的参数约束：

pip download -r requirements.txt ^
    -d C:\offline_pkgs ^
    --platform win_amd64 ^
    --python-version 311 ^
    --implementation cp ^
    --abi cp311 ^
    --only-binary=:all:

该命令会递归解析整个依赖树，并将所有匹配 Windows x64 与 CPython 3.11 的预编译二进制 wheel 文件一次性保存到本地目录中，避免了离线环境下因缺失 C/C++ 编译器而导致源码包编译失败的顽疾。

2. 离线批量安装执行

将 offline_pkgs 目录拷贝至离线主机的 D:\offline_pkgs 后，在嵌入式包目录下执行：

python.exe -m pip install --no-index --find-links=D:\offline_pkgs -r D:\offline_pkgs\requirements.txt

3. 正确的调用方式与脚本封装

为了让业务运维人员或宿主机上的自动化计划任务便于使用，建议在嵌入式包的解压根目录下编写一个轻量级启动包装脚本 run.bat：

@echo off
setlocal
:: 锁定当前脚本所在目录为Python主目录，确保移动文件夹后依旧生效
set "PY_HOME=%~dp0"
set "PATH=%PY_HOME%;%PY_HOME%Scripts;%PATH%"

:: 执行业务程序
"%PY_HOME%python.exe" %*
endlocal

通过该批处理脚本，不仅无需将该Python路径写入系统全局环境变量，还能保证无论是移动到其他盘符，还是拷贝到其他同架构离线机器上，均能开箱即用。

六、常见故障排错与决策避坑

在离线实施嵌入式包的过程中，若遇到异常状态，可依据以下特征矩阵快速定位根因并采取对应措施：

七、总结与最佳实践

通过 Python 官方嵌入式包在 Windows 离线环境中进行部署，核心逻辑可以总结为两句话：“解压即部署，改 pth 通寻址；配 pip 导轮子，调模块保稳定”。采用该方案不仅摆脱了无网环境下复杂 MSI 安装包的困扰，而且将 Python 解释器、标准库、第三方 wheel 依赖及其运行环境完全收敛在一个文件夹中。在日常运维与分发时，可将整个配置完毕的目录打包压缩成自解压归档或分发镜像，在任意同版本 Windows x64 机器上实现即插即用、零污染的高效运行。