Python离线安装包下载与Windows环境部署步骤

在企业内网、生产服务器、涉密机房或网络隔离的工作站中，机器通常无法直接连接外部互联网。在这些 Windows 环境中部署 Python 开发或运行环境，不能直接依赖常规的在线安装与联网 pip install。离线部署的核心在于：先在具备外网访问权限的机器上完整采集官方安装包及项目所需的全部依赖轮子文件（.whl），随后通过物理介质转移到离线机器，最后在本地完成无网络索引的基础安装与批量配置。

一、前期准备与离线部署整体流程

很多初次接触离线部署的读者容易忽略依赖链的准备，仅拷贝了一个 Python 安装程序，导致后续执行项目时因为缺少第三方库而无法运行。完整的离线部署分为四个有序阶段，各个环节必须保持系统架构（如 64 位 x86_64）和 Python 小版本（如 3.11.x）的一致性。

二、在联网机器上下载官方离线安装包与依赖库

该阶段在可以正常上网的计算机上完成。主要包含两部分资产的获取：一是 Python 官方针对 Windows 平台的独立安装文件；二是应用运行所需要的全部第三方模块 wheel 包。

1. 获取 Python 官方离线安装包

访问 Python 官方发布网站 https://www.python.org/downloads/windows/，在稳定版本（Stable Releases）列表中查找目标版本。Windows 平台提供了多种形态的安装文件，务必下载带有 Windows installer (64-bit) 标识的完整可执行程序（例如 python-3.11.8-amd64.exe）。

2. 离线批量下载 Python 第三方依赖包

如果目标机器上需要运行特定代码，先整理出该项目依赖的清单文件 requirements.txt。在联网机器上，利用 pip 提供的 download 指令预先将库文件及其递归依赖项全部下载至指定文件夹中。

在联网机的工作目录下打开命令提示符（CMD）或 PowerShell，执行以下命令：

# 创建存放依赖包的目录
mkdir python_packages

# 批量下载 requirements.txt 中指定的所有依赖项及底层依赖
pip download -d ./python_packages -r requirements.txt

如果联网机器与离线机器的操作系统环境存在差异（例如联网机使用的是 Linux 或 macOS，而离线机是 Windows 64位），则必须显式声明目标平台与 Python 架构，否则下载回来的包可能无法在 Windows 上安装：

pip download -d ./python_packages -r requirements.txt --platform win_amd64 --python-version 311 --only-binary=:all:

执行完毕后，检查 python_packages 目录。里面应当包含一系列以 .whl 结尾的轮子文件（如 requests-2.31.0-py3-none-any.whl）。此外，建议在联网机上同步下载微软官方的 Visual C++ Redistributable（如 VC_redist.x64.exe），以便在离线机缺少 C 运行时库时备用。

三、在 Windows 离线环境中安装与配置 Python

将上述所有文件通过移动硬盘或企业专用介质拷贝到离线 Windows 目标主机的本地磁盘中（建议新建一个专门的目录，例如 C:\Python_Setup\ 或 D:\Python_Setup\）。

1. 运行安装向导与关键选项设置

鼠标右键点击安装程序（如 python-3.11.8-amd64.exe），选择“以管理员身份运行”。进入安装向导首页后，请按照以下要点进行选择：

• 勾选“Use admin privileges when installing py.exe”：使用管理员权限安装启动器，保证系统各账户具备调用能力。
• 务必勾选“Add python.exe to PATH”：安装器会自动将 Python 可执行目录和 Scripts 脚本目录写入 Windows 系统的环境变量，省去后续手动修改路径的麻烦。
• 选择“Customize installation”（自定义安装）：点击进入自定义功能配置页面，不要直接点击上方的“Install Now”。

在弹出的“Optional Features”页面中，保持 Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher 处于勾选状态，然后点击“Next”。

进入“Advanced Options”（高级选项）页面时：

• 勾选 “Install for all users”（为所有用户安装）。勾选该项后，软件会安装到公共系统盘目录下（如 C:\Program Files\Python311 或自定义的 C:\Python311），避免安装在当前用户的 AppData\Local\Programs 隐藏目录下，从而防止其他运维账号登录时找不到环境。
• 在 “Customize install location” 中，建议将路径指定为层级简短、无空格、无中文字符的路径，例如 C:\Python311。
• 点击 “Install” 开始写入文件。

2. 解除路径长度限制（Disable path length limit）

安装过程完成时，向导末尾通常会出现名为 “Disable path length limit” 的按钮。Windows 默认对单个文件路径具有 260 个字符的传统限制（MAX_PATH）。现代 Python 库特别是深度嵌套的模块在安装时极易超出该限制导致构建失败，因此建议直接点击该按钮解除限制，随后点击“Close”关闭向导。

3. 手动补全环境变量（若安装时漏勾选）

如果由于误操作未勾选 PATH 选项，可在系统中手动添加：

1. 按下快捷键 Win + R，输入 sysdm.cpl 并回车，打开“系统属性”窗口。
2. 切换到“高级”选项卡，点击下方的“环境变量”按钮。
3. 在“系统变量”区域中找到名为 Path 的变量，选中后点击“编辑”。
4. 点击“新建”，分别添加以下两条路径（假设安装路径为 C:\Python311）：
   • C:\Python311\（解释器主程序所在目录）
   • C:\Python311\Scripts\（pip 及外部工具命令所在目录）
5. 依次点击“确定”保存所有窗口并退出。重新打开一个全新的命令行窗口使变量生效。

四、离线安装第三方依赖库与运行验证

当 Python 基础环境安装就绪后，接下来需要在完全断网的状态下，将之前采集的 wheel 包批量部署到 Python 运行环境中。

1. 批量离线安装命令

在离线 Windows 主机中打开命令提示符，通过 cd 命令切换到存放安装文件与 requirements.txt 的目录，执行以下核心安装命令：

# 核心参数说明：
# --no-index: 告知 pip 不要连接远程 PyPI 仓库，直接跳过在线检索
# --find-links: 告知 pip 本地轮子文件（.whl）的存储路径

pip install --no-index --find-links=D:\Python_Setup\python_packages -r requirements.txt

pip 会在 D:\Python_Setup\python_packages 目录中遍历匹配所需的文件，并自动解析各个库之间的依赖关系完成安装。由于不需要网络握手与下载，整个安装过程往往只需要数秒至数十秒即可完成。

2. 单个第三方包的手动离线安装

如果后续临时需要安装某个单独的工具包（例如 wheel 或 requests），而没有维护清单文件，也可以直接将文件路径传给 pip：

# 直接安装指定本地 wheel 文件
pip install --no-index --find-links=D:\Python_Setup\python_packages requests-2.31.0-py3-none-any.whl

3. 基础功能与依赖可用性验证

安装完成后，通过以下几条具体的命令来确认环境的完备性：

# 1. 验证 Python 解释器版本
python --version
# 正确输出示例：Python 3.11.8

# 2. 查看当前可执行程序对应的具体路径
where python
# 正确输出示例：C:\Python311\python.exe

# 3. 验证 pip 包管理工具及已安装列表
pip list
# 此时终端应完整列出 requirements.txt 中所包含的所有模块及版本

# 4. 运行单行代码测试第三方库的导入功能
python -c "import requests; print('requests version:', requests.__version__)"
# 正确输出示例：requests version: 2.31.0

五、常见问题排查与注意事项

1. 提示找不到 api-ms-win-crt-runtime-l1-1-0.dll

这是在较旧版本的 Windows（如 Windows 7、Windows Server 2008/2012）上非常容易出现的报错。原因是目标操作系统缺少 Universal C Runtime (CRT) 运行库。解决办法是运行之前准备好的 VC_redist.x64.exe 安装程序，完成 Microsoft Visual C++ 运行库的离线安装后重启命令行即可。

2. 执行 pip 提示网络超时（Connecting to pypi.org... timed out）

如果执行 pip install 时依然出现尝试连接外网的超时错误，说明命令中漏掉了 --no-index 参数。在离线状态下，如果没有 --no-index，pip 即使在本地找到了对应的包，默认行为仍可能先去官方索引源比对元数据或寻找更新的版本，从而卡在网络请求上。必须同时显式指定 --no-index 和 --find-links。

3. 报错“Failed building wheel”或“Microsoft Visual C++ 14.0 is required”

部分包含 C/C++ 扩展的第三方库（例如特定版本的 numpy、lxml、psycopg2），如果在联网机下载时只下载到了源码包（.tar.gz 或 .zip），那么在离线机安装时 pip 会尝试在本地进行编译。由于离线机通常没有安装 Visual Studio C++ 编译环境，便会引发构建报错。解决此问题的关键是在前期联网机下载时，确保获取的是预先构建好的 .whl 二进制轮子文件，或者在联网机执行下载命令时加上 --only-binary=:all: 参数，强制要求全部下载轮子包。