Python 开发涉及多种文件后缀，理解其用途对工程实践至关重要。.py 为源代码；.ipynb 用于交互式数据分析；.pyi 提供静态类型提示；.pyc 存储编译后的字节码；.pyd 是 Windows 下的二进制扩展模块；.pyw 用于无控制台窗口应用；.pyx 则是 Cython 源码。详细解析各文件格式特性、生成方式、适用场景及性能差异，帮助开发者规范项目结构并优化代码执行效率。
在 Python 生态系统中，开发者会接触到多种不同后缀的文件。理解每种文件的用途、生成方式及适用场景，对于规范项目结构、优化代码性能以及进行安全审计都至关重要。本文将详细解析 .py、.ipynb、.pyi、.pyc、.pyd、.pyw 以及 .pyx 等核心文件类型的特性。
.py 是最标准的 Python 源代码文件后缀，由官方定义。它包含人类可读的文本代码，是 Python 解释器直接执行的对象。
python filename.py 运行。.pyc 字节码文件并存储在 __pycache__ 目录下，以加速后续加载。建议将公共库代码与业务逻辑分离，保持目录结构清晰。避免在 .py 文件中硬编码敏感信息，应使用环境变量或配置文件管理。
.ipynb 是 Jupyter Notebook 的专用文件格式，全称为 IPython Notebook。它以 JSON 格式存储代码单元（Cell）、输出结果、Markdown 说明及元数据。
由于 .ipynb 文件本质是 JSON，合并冲突时较难处理。生产环境中通常将其导出为 .py 脚本部署，而非直接运行 notebook。
.pyi 文件用于存放 Python 的类型提示（Type Hints）信息，遵循 PEP 484 标准。它们不包含具体的函数实现，仅声明接口签名。
mypy 等工具，可在不运行代码的情况下发现类型错误。.py 文件一致，例如 module.py 对应 module.pyi。# example.pyi
def calculate_total(price: float, tax_rate: float) -> float:
...
.pyc 是 Python 源代码编译后的中间表示形式（Bytecode）。它是二进制文件，无法直接用文本编辑器阅读。
.pyc 可能不兼容。手动编译可使用命令 python -m compileall directory。建议在 .gitignore 中忽略 __pycache__ 目录，避免污染版本仓库。
.pyd 是 Windows 平台下 Python 扩展模块的二进制文件后缀，本质上是一个动态链接库（DLL）。它允许通过 C 或 C++ 编写高性能代码并与 Python 交互。
import 语句调用，如同普通模块一样。.so，macOS 下对应 .dylib。适用于对性能要求极高的计算密集型任务，如图像处理、加密算法或硬件驱动封装。
.pyw 是 Windows 特有的脚本后缀，用于运行不需要命令行界面（Console Window）的 GUI 应用程序。
# 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()
.pyx 是 Cython 语言的源代码文件后缀。Cython 是一种静态类型扩展语言，允许在 Python 语法基础上添加 C 类型声明，从而编译为 C 扩展以提高性能。
.pyx 运行，只需添加类型注解即可享受加速。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 | 源代码 | 日常开发、脚本 | 是 |
| .ipynb | 笔记本 | 数据分析、教学 | 是 (JSON) |
| .pyi | 存根 | 类型提示、接口定义 | 是 |
| .pyc | 字节码 | 缓存加速 | 否 |
| .pyd | 扩展模块 | Windows 二进制插件 | 否 |
| .pyw | 窗口脚本 | GUI 应用入口 | 是 |
| .pyx | Cython | 高性能计算 | 是 |
在实际项目中，建议保留 .py 和 .pyx 作为源码，.pyi 随包发布以提升 IDE 体验，而 .pyc 和 .pyd 应由构建工具自动生成，不应提交至版本控制系统。对于涉及商业机密的核心算法，可考虑使用 Cython 编译为 .pyd 或 .so 文件，但需注意这并非绝对安全的保护措施。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online