Python导包、分包与打包的完整教程

# 一个.py文件就是一个模块
# example.py 就是一个名为example的模块
def say_hello():
    print("你好！")


def add(a, b):
    return a + b

# 包是一个包含__init__.py文件的文件夹
my_package/
    __init__.py    # 这个文件让Python知道这是包
    module1.py
    module2.py

项目结构：
project/
    main.py
    utils.py

# utils.py
def greet(name):
    return f"你好，{name}！"


def calculate_sum(numbers):
    return sum(numbers)

# main.py - 方法1：导入整个模块
import utils

result = utils.greet("小明")
print(result)  # 输出：你好，小明！

total = utils.calculate_sum([1, 2, 3, 4, 5])
print(total)   # 输出：15

# main.py - 方法2：导入特定功能
from utils import greet, calculate_sum

result = greet("小红")  # 直接使用，不用加 utils.
print(result)

# main.py - 方法3：导入并重命名
from utils import greet as say_hello

say_hello("小张")  # 使用新名字

# Python内置库
import math
import random
import datetime

# 第三方库（需要先安装）
# pip install requests
import requests

my_project/
│   main.py
│
├───database/
│   │   __init__.py
│   │   connector.py
│   │   models.py
│
└───utils/
    │   __init__.py
    │   math_tools.py
    │   string_tools.py

# main.py
from database.connector import connect_db
from utils.math_tools import add_numbers
from utils.string_tools import format_text

# 在 database/models.py 中
from .connector import connect_db    # . 表示同一目录
from ..utils.math_tools import add_numbers  # .. 表示上级目录

# 在 database/models.py 中
from database.connector import connect_db    # 与main同一目录
from utils.math_tools import add_numbers  # 与main同一目录

# database/__init__.py
# 空文件也可以，但有它才算是包

# utils/__init__.py
# 集中导入，方便外部使用
from .math_tools import *
from .string_tools import *


# 或者更精确的控制
__all__ = ['add_numbers', 'multiply_numbers', 'format_text']

# 这样在外面就可以
from utils import add_numbers  # 不需要知道math_tools的存在

# utils/__init__.py
# 包版本信息
__version__ = "1.0.0"
__author__ = "你的名字"


# 包初始化代码
print("正在加载工具包...")


# 包级别的配置
DEFAULT_CONFIG = {
    "log_level": "INFO",
    "timeout": 30
}

simple_app/
    app.py          # 主程序
    config.py       # 配置
    helpers.py      # 辅助函数
    data.json       # 数据文件

medium_app/
│   main.py                    # 程序入口
│   requirements.txt           # 依赖列表
│   README.md                 # 说明文档
│
├───core/                     # 核心业务逻辑
│   │   __init__.py
│   │   calculator.py        # 计算器类
│   │   validator.py         # 验证器
│
├───ui/                       # 用户界面
│   │   __init__.py
│   │   window.py           # 主窗口
│   │   widgets.py          # 小部件
│
├───data/                     # 数据处理
│   │   __init__.py
│   │   loader.py           # 数据加载
│   │   saver.py            # 数据保存
│
└───utils/                   # 通用工具
    │   __init__.py
    │   logger.py           # 日志工具
    │   formatter.py        # 格式化工具

professional_app/
│
├───src/                     # 源代码目录（推荐结构）
│   └───my_app/              # 你的包名
│       │   __init__.py
│       │   __main__.py     # 命令行入口：python -m my_app
│       │   cli.py          # CLI接口
│       │   config.py       # 配置管理
│       │
│       ├───core/
│       │   │   __init__.py
│       │   │   business_logic.py
│       │   │   models.py
│       │
│       ├───api/
│       │   │   __init__.py
│       │   │   routes.py
│       │   │   handlers.py
│       │
│       └───utils/
│           │   __init__.py
│           │   helpers.py
│           │   decorators.py
│
├───tests/                   # 测试目录
│   │   __init__.py
│   │   test_core.py
│   │   test_utils.py
│   │   conftest.py         # pytest配置
│
├───docs/                    # 文档
│       index.md
│       tutorial.md
│
├───examples/               # 示例代码
│       basic_usage.py
│       advanced_features.py
│
├───scripts/                # 脚本
│       setup_env.py
│       generate_data.py
│
│   .gitignore              # Git忽略文件
│   pyproject.toml          # 项目配置（现代方式）
│   setup.py               # 安装配置（传统方式）
│   README.md              # 项目说明
│   LICENSE               # 许可证
└───requirements.txt       # 依赖包列表

# 在命令行中执行
pip install pyinstaller


# 验证安装
pyinstaller --version

# 最简单的打包
pyinstaller your_program.py


# 打包后，在 dist/ 文件夹中找到可执行文件

# 1. --onefile：打包成单个文件
pyinstaller --onefile main.py


# 2. --windowed：无控制台窗口（适合GUI程序）
pyinstaller --windowed gui_app.py


# 3. --icon：设置图标
pyinstaller --onefile --windowed --icon=my_icon.ico main.py


# 4. --name：指定输出文件名
pyinstaller --name "我的应用" main.py


# 5. --add-data：添加额外文件（如配置文件、图片）
# Windows格式：源文件路径;目标路径
# Linux/Mac格式：源文件路径:目标路径
pyinstaller --add-data "config.ini;." main.py
pyinstaller --add-data "images/*.png:images" main.py


# 6. --hidden-import：添加隐藏的依赖
pyinstaller --hidden-import=tkinter main.py

# 假设你有一个 tkinter 程序
pip install pyinstaller


# 进入项目目录
cd your_project_folder


# 打包命令
pyinstaller --onefile --windowed --icon=app.ico --name "我的应用" ^
            --add-data "images;images" ^
            --add-data "config.ini;." ^
            main.py

# 生成初始spec文件
pyi-makespec main.py


# 或者从已经打包的项目中复制

# main.spec
# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['main.py'],  # 主程序文件
    pathex=[],    # 搜索路径
    binaries=[],  # 二进制文件
    datas=[       # 数据文件
        ('config.ini', '.'),
        ('images/*.png', 'images'),
        ('sounds/*.wav', 'sounds')
    ],
    hiddenimports=[  # 隐藏的依赖
        'tkinter',
        'PIL._tkinter_finder'
    ],
    hookspath=[],    # 钩子路径
    hooksconfig={},  # 钩子配置
    runtime_hooks=[],  # 运行时钩子
    excludes=[],     # 排除模块（减少体积）
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=None,     # 加密字节码
    noarchive=False  # 不打包成archive
)


# 打包成单个文件
pyz = PYZ(a.pure, a.zipped_data, cipher=None)


exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='我的应用',  # 输出文件名
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,        # 使用UPX压缩
    console=False,   # 显示控制台？True/False
    icon='app.ico',  # 图标
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None
)


coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='我的应用'  # 文件夹名称
)

# 使用spec文件打包
pyinstaller main.spec

pip install cx-Freeze