### 如何导出和安装 Python 的离线包 #### 导出 Python 离线包的方法 为了实现 Python 依赖包的离线迁移，可以通过以下方式导出所需的依赖包及其版本信息： 1. **生成需求文件 `requirements.txt`** 使用 `pip freeze` 命令将当前环境中已安装的所有包及其版本号写入到一个文本文件中。这一步用于记录环境中的所有依赖项。 ```bash pip freeze > ./requirements.txt ``` 如果希望更精确地按项目实际使用的模块来生成需求文件，则可以使用工具 `pipreqs` 来扫描项目的代码并生成对应的依赖列表[^1]。 2. **下载离线包** 利用 `pip download` 命令按照需求文件的内容下载所有必要的 `.whl` 或其他格式的包文件至指定目录。 ```bash pip download -d your_offline_packages -r requirements.txt ``` 此外，如果需要加速下载过程或解决国内访问 PyPI 官方源较慢的问题，可以选择镜像站点作为索引地址，例如豆瓣源： ```bash pip download -d D:\test -i https://pypi.douban.com/simple -r requirements.txt ``` #### 安装 Python 离线包的方法 完成上述步骤后，在无网络连接的目标设备上执行如下操作即可完成依赖包的安装： 1. **完全离线模式下的安装** 当目标机器没有任何互联网接入能力时，需采用 `--no-index` 参数告知 pip 不尝试在线查询任何资源，并通过 `--find-links` 指向本地存储这些预下载好的软件包的位置。 ```bash pip install --no-index --find-links=./your_offline_packages -r requirements.txt ``` 2. **部分离线模式下的安装** 若允许一定程度上的联网行为（仅当某些未被提前缓存下来的子依赖存在缺失情况才回退至线上获取），那么可以直接省略掉 `--no-index` 开关而保留 `--find-links` 设置指向本地仓库路径。 ```bash pip install --find-links=./your_offline_packages -r requirements.txt ``` 3. **单独某个包的手动安装** 对于个别特殊场景下只需针对单一组件实施部署动作而非整个清单的情形来说，同样支持直接指明待处理对象名称来进行独立作业。 ```bash pip install --no-index --find-links=./your_offline_packages package_name ``` 需要注意的是，`.whl` 文件一旦成功下载之后就不应该随意更改其原始命名规则以免造成后续解析失败等问题；另外对于那些可能涉及操作系统差异性的第三方扩展库尤其要注意匹配好具体平台架构特性再行动作[^3]。 ```python # 示例脚本：自动化导出与导入流程 import os from subprocess import run def export_requirements(output_dir='offline_packages'): """Export current environment's packages to a directory.""" if not os.path.exists(output_dir): os.makedirs(output_dir) # Generate the list of installed packages. with open('requirements.txt', 'w') as f: result = run(['pip', 'freeze'], stdout=f, check=True) # Download all required packages into output_dir. run(['pip', 'download', '-d', output_dir, '-r', 'requirements.txt'], check=True) def install_from_directory(requirements_file='requirements.txt', source_dir='.'): """Install from previously downloaded files within given dir.""" command = [ 'pip', 'install', '--no-index', f'--find-links={source_dir}', f'-r {requirements_file}' ] run(command, check=True) ```