Python文件类型大全：从.py到.pyd，你见过几种？

👉 项目官网：https://www.python-office.com/ 👈

👉 本开源项目的交流群 👈

github star gitee star gitcode star PyPI Downloads AI编程训练营

fC3GSciU1.png

大家好，我是程序员晚枫。

最近有了AI编程，Python的热度降低了，我也终于有时间关注一直感兴趣的Python话题，而不是回答Python怎么安装这种入门问题了。

我对于Python兴趣的探索，主要基于两本书：《流畅的Python》、《Python高性能编程》。越深入了解Python高级语法，越能深入理解这门语言设计的精妙之处。

今天我们来聊聊Python世界中那些形形色色的文件类型。

作为一个Python开发者，你肯定经常跟.py文件打交道。但Python生态中其实还有很多其他重要的文件类型，每种都有其独特的用途。

📁 Python核心文件类型

文件类型 主要用途 是否可读 生成方式
.py Python源代码 ✅ 是 手动创建
.pyc 编译后的字节码 ❌ 否 Python自动生成
.pyo 优化后的字节码 ❌ 否 Python带-O参数生成
.pyd Windows动态链接库 ❌ 否 Cython/C扩展编译
.so Linux/Mac动态库 ❌ 否 Cython/C扩展编译
.pyw 无控制台Python脚本 ✅ 是 手动创建
.pyx Cython源代码 ✅ 是 手动创建

有一些文件类型你可能没见过，有2种原因：

  • 你没有这么复杂的工作场景，例如so文件的使用
  • 部分类型被编辑器给自动屏蔽了，例如：pyc文件

🔧 详细解析

1. .py - Python源代码文件

这是最常见的Python文件，包含人类可读的Python代码。

1
2
3
4
5
6
# hello.py
def greet(name):
    return f"Hello, {name}!"

if __name__ == "__main__":
    print(greet("Python开发者: 程序员晚枫"))

2. .pyc - 编译字节码文件

Python解释器将.py文件编译成字节码，加速后续执行。

生成方式：

1
2
# Python会自动在__pycache__目录生成.pyc文件
python -m py_compile hello.py

文件结构：

  • 位于__pycache__目录
  • 命名格式：hello.cpython-39.pyc
  • 包含Python字节码，不是机器码

3. .pyd - Windows动态链接库

.pyd文件本质上是DLL文件，但可以被Python直接导入。

这种类型，可以理解为java中的jar包格式，可以打包后给别人使用。

创建示例（使用Cython）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 安装Cython
pip install cython

# 创建Cython文件
# hello.pyx
def cython_greet(name):
    return f"Hello from Cython, {name}!"

# setup.py
from setuptools import setup
from Cython.Build import cythonize

setup(ext_modules=cythonize("hello.pyx"))

# 编译生成.pyd
python setup.py build_ext --inplace

使用.pyd文件：

1
2
3
# 像普通模块一样导入
import hello
print(hello.cython_greet("程序员晚枫"))

4. .pyx - Cython源代码文件

Cython是Python的超集，允许编写C扩展。

1
2
3
4
5
6
7
# fastmath.pyx
def fibonacci(int n):
    cdef int i
    cdef double a = 0.0, b = 1.0
    for i in range(n):
        a, b = b, a + b
    return a

5. .pyw - 无控制台脚本

在Windows上，.pyw文件运行时不会显示控制台窗口，适合GUI应用。

1
2
3
4
5
6
# my_app.pyw
import tkinter as tk

root = tk.Tk()
root.title("无控制台应用")
root.mainloop()

📦 包与分发文件

包相关文件

文件类型 用途
init.py 包初始化文件（Python 3.3+可选）
main.py 包作为脚本执行时的入口

分发与安装

文件类型 用途
.whl Python包的分发格式（wheel）
.egg 旧版包分发格式
setup.py 包安装脚本
setup.cfg 包配置
pyproject.toml 现代包配置
requirements.txt 依赖列表

🛠️ 配置文件类型

项目配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# pyproject.toml（现代Python项目）
[build-system]
requires = ["setuptools", "wheel"]

[project]
name = "my-project"
version = "0.1.0"

# setup.cfg（传统配置）
[metadata]
name = my-project
version = 0.1.0

# requirements.txt
requests>=2.25.0
pandas>=1.3.0

环境与工具配置

文件类型 用途
.python-version pyenv版本文件
Pipfile pipenv依赖管理
Pipfile.lock 依赖锁文件
environment.yml conda环境配置

🔍 特殊用途文件

1. .pyi - 存根文件

用于类型提示，不包含实现代码。

1
2
3
# math.pyi
def sqrt(x: float) -> float: ...
def pow(x: float, y: float) -> float: ...

2. .pth - 路径配置文件

在Python路径中添加自定义路径。

1
2
3
# my_paths.pth
/home/user/my_python_libs
../relative/path/to/modules

3. .pyz - 自包含应用

包含所有依赖的zip应用。

1
2
3
4
5
# 创建.pyz文件
python -m zipapp my_app -o app.pyz

# 运行
python app.pyz

💻 开发工具文件

测试相关

1
2
3
4
5
6
7
8
9
10
11
12
# test_example.py
import pytest

def test_addition():
    assert 1 + 1 == 2

# conftest.py（pytest配置）
import pytest

@pytest.fixture
def sample_data():
    return {"key": "value"}

代码质量

文件类型 用途
.pylintrc Pylint配置
.flake8 Flake8配置
.coveragerc 测试覆盖率配置
.pre-commit-config.yaml Git钩子配置

🎯 实际项目示例

一个典型的Python项目结构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
my_project/
├── src/
│   ├── __init__.py
│   ├── main.py
│   └── utils.py
├── tests/
│   ├── __init__.py
│   └── test_main.py
├── docs/
│   └── conf.py
├── .python-version
├── pyproject.toml
├── requirements.txt
├── setup.py
└── README.md

💡 实用技巧

1. 查看.pyc文件内容

1
python -m dis hello.pyc

2. 将Python包编译成.pyd

1
2
3
4
5
6
7
8
9
# 使用Cython批量编译
from Cython.Build import cythonize
from setuptools import setup, Extension

extensions = [
    Extension("my_module", ["my_module.pyx"])
]

setup(ext_modules=cythonize(extensions))

3. 创建专业的分发包

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# setup.py
from setuptools import setup, find_packages

setup(
    name="my-package",
    version="1.0.0",
    packages=find_packages(),
    install_requires=[
        "requests>=2.25.0",
    ],
    entry_points={
        'console_scripts': [
            'my-command=my_package.cli:main',
        ],
    },
)

🚀 性能对比：.py vs .pyd

在某些场景下，编译成.pyd可以显著提升性能：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 性能测试示例
import timeit

# Python版本
def python_fib(n):
    if n <= 1:
        return n
    return python_fib(n-1) + python_fib(n-2)

# Cython编译版本（假设已编译为.pyd）
from cython_fib import cython_fib

# 测试性能
n = 35
python_time = timeit.timeit(lambda: python_fib(n), number=1)
cython_time = timeit.timeit(lambda: cython_fib(n), number=1)

print(f"Python: {python_time:.2f}s")
print(f"Cython: {cython_time:.2f}s")
print(f"加速比: {python_time/cython_time:.1f}x")

📊 总结

Python的文件生态系统非常丰富，从源代码到编译文件，从配置到分发，每种文件类型都有其特定用途：

  • 开发阶段：主要使用.py、.pyx
  • 运行阶段：涉及.pyc、.pyd、.so
  • 分发阶段：使用.whl、.egg
  • 配置管理：各种配置文件

掌握这些文件类型的特点和用途，能够帮助你更好地组织项目、优化性能和管理依赖。

互动话题：你在项目中还遇到过哪些特殊的Python文件类型？欢迎在评论区分享你的经验！

资源推荐：

如果觉得本文对你有帮助，请点赞、在看、转发支持！

另外，大家去给小明的小红书👇账号点点赞吧~！我不想努力了，想吃软饭了。

小红书：爱吃火锅的小明

扫一扫，领红包

美团红包

展开全文 >>

给小白的《12讲 · AI编程训练营》第3讲-3分钟用Qoder开发一个自己的办公软件

github star gitee star gitcode star PyPI Downloads AI编程训练营

AI编程-横

导读部分：这一讲，我们介绍AI编程的基本用法，并且将使用Qoder完成第一个AI编程的开发。

大家好，这里是程序员晚枫。

第3讲：初试牛刀：使用Qoder完成你的第一个程序

大家好，我是程序员晚枫。在上一讲中，我们配置了AI编程工具：点我查看

今天，让我们真正上手，使用国产AI IDE——Qoder，结合python-office库，完成你的第一个AI办公自动化程序！

实战：开发一个自动化办公小程序

步骤1：安装Python

这是本次课程中唯一 一个需要人工操作的步骤。

还没有安装Python的朋友，可以去看我录制的视频：

这里顺便说一下：虽然今年Python已经发布了Python3.14，但答应我，用3.11就够了。
Python 3.14正式发布！这5大新特性值得尝试

步骤2：在Qoder中安装python-office库

打开Qoder的内置终端，输入：

1
pip install python-office -U

验证安装：新建Python文件，输入以下代码测试：

1
2
3
4
import office

# 测试python-office是否安装成功
print(office.__version__)

截止写这套课的晚上，以上这个代码，经过AI的测试后应该输出：1.0.6

运行后看到正确的版本信息，说明环境配置成功！

步骤3：给本次任务写一个清晰的完成步骤

从这一讲开始，都在我的第3讲付费直播里演示了。

训练营的朋友可以免费看直播回放，大家＋我微信：wfdev7，找我要。
（悄悄说：这样我也知道你学到第3讲了！）

Qoder特有功能展示

1. 智能代码解释

选中任何python-office代码，按Ctrl+Shift+I，AI会详细解释代码功能和使用方法。

2. 一键性能优化

右键选择”AI优化”，Qoder会自动分析代码性能并提出改进建议。

3. 智能API推荐

输入office.后，Qoder会根据上下文推荐最合适的python-officeAPI。

实战作业：深度体验Qoder

任务：使用Qoder创建一个解决实际工作痛点的工具

要求：

  1. 用自然语言描述需求（中文即可）
  2. 使用AI生成初步代码
  3. 基于python-office进行功能完善
  4. 使用Qoder的调试功能解决遇到的问题

示例：

1
2
3
需求描述：
"我需要一个自动备份工具，每天下午6点自动备份指定文件夹到云端，
并给我发送微信通知，告诉我备份是否成功"

常见问题解答

Q：Qoder是免费的吗？
A：不是免费的，但是本套课程提供免费版，包含大部分AI功能，完全满足学习需求。白嫖方式：白嫖 Qoder 的两种正确姿势：pro积分 + 永久 Lite 模式全攻略

Q：Qoder支持团队协作吗？
A：支持！内置了代码评审、实时协作等团队功能

Q：如何提高Qoder的代码生成质量？
A：提供详细的需求描述，包括输入、输出、异常处理要求

下一讲预告

在第4讲中，我们将深入学习python-office的热门功能，并以一个真实业务场景为例，在Qoder中开发完整的办公自动化解决方案。

本节课的收获：

  • 掌握了Qoder的基本操作和AI功能
  • 学会了在Qoder中高效使用python-office
  • 完成了第一个AI办公自动化程序
  • 体验了新一代国产IDE的开发效率

课后任务：

  1. 在Qoder中完成个人办公助手项目
  2. 体验至少3个AI编程功能
  3. 在课程群分享你的Qoder使用体验

我是程序员晚枫，我们下一讲见！

联系我

有任何问题，欢迎联系我的微信👉python-office

展开全文 >>

本站总访问量次

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

编程博主，全网粉丝30w+，开源项目：python-office，我的微信：wfdev7