🐍 Python 3.x 完全指南

📋 基本信息

💾 下载文件说明

官网下载页提供多种文件类型，选择指南：

  • 📦 源码tarball：源代码包，适合高级用户编译
  • 🍎 macOS安装包：适用于苹果电脑的安装程序
  • 🖥️ Windows安装包：
    • 32位/64位/ARM64版本的installer
    • 推荐新手使用
  • 🧩 Windows嵌入包：
    • 32位/64位/ARM64版本的embeddable包
    • 适合分发作品或嵌入其他程序时使用

🔧 pip 包管理工具

pip是Python的官方包管理工具，类似Ubuntu的apt：

📄 常用文件后缀名

  • .py：Python脚本源码文件
  • .pyc：编译后的字节码文件（embed版除标准库外可删除，通常在__pycache__文件夹中）
  • .pyd：平台相关的二进制文件（类似动态链接库）
  • .pth：包查找路径的配置文件
  • .whl：pip支持的包文件（本质是ZIP文件）

📦 WHL文件使用

  • 解压到python.exe所在文件夹/Lib/site-packages/下即可使用
  • 文件名包含any表示与平台或体系无关
  • Win7下常用基础包：
    • pip-25.0.1-py3-none-any.whl
    • setuptools-75.3.2-py3-none-any.whl
    • wheel-0.45.1-py3-none-any.whl

🔄 运行pip的替代方式

直接解压的pip没有生成Scripts下的pip.exe，可使用：

python -m pip xxx

🌍 更换pip源地址

  • 临时使用：

    pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/

  • 永久设置：
    在C:\Users\你的用户名\pip目录下创建pip.ini文件：

    [global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

💾 pip缓存位置

Windows下的缓存文件夹：

C:\Users\用户名\AppData\Local\pip\

下载的包文件以hash.body命名，需自行识别。

🧩 Embed版安装pip步骤

  1. 下载并解压Python嵌入式版本
  2. 下载get-pip.py：https://bootstrap.pypa.io/get-pip.py
  3. 运行python get-pip.py
  4. 修改（或删除）pythonXX._pth文件，取消对import site的注释
  5. 完成后可使用：Scripts\pip.exe install xxx.whl

🛠️ Embed版特性

  • Lib文件夹：存放库文件
  • python3xx._pth文件：控制库文件查找路径，每行一个地址
  • 路径自定义：
    例如创建../mypip/文件夹，在pth文件添加一行../mypip，
    即可将./Lib/site-packages/下的文件移动到../mypip/

📁 Scripts文件夹

存放程序引导器，本质是：
不同体系的exe头 + #!D:\py目录\python.exe + 0x0A + zip(store(main.py))

  • WinX86 Exe头位置：pip/_vendor/distlib/t32.exe
  • WinX64 Exe头位置：pip/_vendor/distlib/t64.exe

注意：引导器包含python.exe的绝对路径，移动位置后会失效，可使用python -m pip list替代，或编辑exe文件修改路径。

🔧 包版本修改

以tls_fragment-3.3.0-py3-none-any.whl为例：

  1. 将whl文件视为zip文件解压
  2. 修改tls_fragment-3.3.0.dist-info\METADATA中对Python版本的要求
  3. 重新压缩为zip，改回.whl后缀

🚀 在线部署程序示例（以tls_fragment为例）

在Win7 x86平台：

  1. 下载python-3.8.0-embed-win32.zip和/3.8/get-pip.py
  2. 解压到D:/python3/，复制get-pip.py和tls_fragment的whl文件到该文件夹
  3. 编辑python38._pth，去掉import site前的井号
  4. 命令行进入该文件夹：cd /d D:\python3\
  5. 安装pip：python.exe get-pip.py
  6. 安装程序：python.exe -m pip install tls_fragment-3.3.0-py3-none-any.whl
  7. 运行：D:\python3\python.exe -m tls_fragment.cli（进入config.json所在目录后可简化）

📦 离线部署程序示例（以tls_fragment为例）

在Win7 x86平台：

  1. 下载python-3.8.0-embed-win32.zip并解压到D:/python3/

  2. 创建Lib/site-packages/两级文件夹

  3. 编辑python38._pth，去掉import site前的井号

  4. 从https://pypi.org下载所需依赖包：

    • ahocorasick_python-0.0.9-py3-none-any.whl
    • certifi-2025.8.3-py3-none-any.whl
    • charset_normalizer-3.4.3-cp38-cp38-win32.whl（注意匹配平台）
    • dnspython-2.6.1-py3-none-any.whl
    • idna-3.10-py3-none-any.whl
    • requests-2.32.4-py3-none-any.whl
    • tls_fragment-3.3.0-py3-none-any.whl
    • urllib3-2.2.3-py3-none-any.whl

  5. 将所有whl包解压到D:/python3/Lib/site-packages/

  6. 运行：D:\python3\python.exe -m tls_fragment.cli

注意：ahocorasick-python包可能只有旧版egg包，可从pip缓存文件夹找到转换后的whl包。