详解 Python 常见文件类型：.py、.ipynb、.pyi、.pyc、.pyd 及扩展

核心特性

• 加载加速：解释器无需重复编译源代码，直接从磁盘读取字节码，提升启动速度。
• 非加密保护：虽然不可读，但可通过反编译工具还原源码，因此不能作为真正的代码保护手段。
• 版本敏感：字节码包含 Python 版本号信息，不同版本的 Python 生成的 .pyc 可能不兼容。

生成与管理

手动编译可使用命令 python -m compileall directory。建议在 .gitignore 中忽略 __pycache__ 目录，避免污染版本仓库。

5. .pyd (Windows 扩展模块)

.pyd 是 Windows 平台下 Python 扩展模块的二进制文件后缀，本质上是一个动态链接库（DLL）。它允许通过 C 或 C++ 编写高性能代码并与 Python 交互。

核心特性

• 跨语言集成：主要用于调用底层系统 API 或高性能计算库（如 NumPy 的部分组件）。
• 导入透明：在 Python 代码中通过 import 语句调用，如同普通模块一样。
• 平台限制：仅在 Windows 上有效，Linux 下对应 .so，macOS 下对应 .dylib。

应用场景

适用于对性能要求极高的计算密集型任务，如图像处理、加密算法或硬件驱动封装。

6. .pyw (无控制台窗口脚本)

.pyw 是 Windows 特有的脚本后缀，用于运行不需要命令行界面（Console Window）的 GUI 应用程序。

核心特性

• 隐藏控制台：双击运行时不会弹出黑底白字的 CMD 窗口，用户体验更整洁。
• 重定向限制：标准输出（stdout）和标准错误（stderr）默认被丢弃，调试时需使用日志记录代替 print。
• GUI 应用首选：常用于 Tkinter、PyQt 等图形界面程序的入口脚本。

示例

# app.pyw
import tkinter as tk

def on_click():
    label.config(text="Clicked!")

root = tk.Tk()
button = tk.Button(root, text="Click Me", command=on_click)
button.pack()
label = tk.Label(root, text="Hello")
label.pack()
root.mainloop()

7. .pyx (Cython 源代码)

.pyx 是 Cython 语言的源代码文件后缀。Cython 是一种静态类型扩展语言，允许在 Python 语法基础上添加 C 类型声明，从而编译为 C 扩展以提高性能。

核心特性

• 性能优化：通过静态类型检查和 C 编译，可显著提升循环和数值计算的速度。
• 兼容性：大部分合法的 Python 代码可直接作为 .pyx 运行，只需添加类型注解即可享受加速。
• 构建流程：需要安装 Cython 并使用 setup.py 或 pyproject.toml 进行编译打包。

性能对比示例

以下展示了纯 Python 与 Cython 在斐波那契数列计算上的性能差异：

# pure_python.py
def fibonacci(n):
    if n <= 0:
        raise ValueError("n 必须是正整数")
    if n == 1:
        return 0
    elif n == 2:
        return 1
    else:
        a, b = 0, 1
        for _ in range(3, n + 1):
            a, b = b, a + b
        return b

# fib.pyx
def fibonacci(int n):
    if n <= 0:
        raise ValueError("n 必须是正整数")
    if n == 1:
        return 0
    elif n == 2:
        return 1
    else:
        cdef int a = 0, b = 1
        for i in range(3, n + 1):
            a, b = b, a + b
        return b

在基准测试中，Cython 版本在处理大量迭代时，执行时间通常可减少 50% 以上，具体取决于类型注解的完善程度。

总结与建议

在实际项目中，建议保留 .py 和 .pyx 作为源码，.pyi 随包发布以提升 IDE 体验，而 .pyc 和 .pyd 应由构建工具自动生成，不应提交至版本控制系统。对于涉及商业机密的核心算法，可考虑使用 Cython 编译为 .pyd 或 .so 文件，但需注意这并非绝对安全的保护措施。