清理Python项目构建文件：告别setup.py的时代-Python教程-PHP中文网

清理Python项目构建文件：告别setup.py的时代

花韻仙語

发布： 2025-08-25 21:24:34

原创

584人浏览过

清理python项目构建文件：告别setup.py的时代

清理Python项目构建文件，告别setup.py的时代。随着setup.py的弃用和pyproject.toml的普及，我们需要掌握新的清理策略。本文将指导你手动识别并删除常见的构建产物，确保项目目录的整洁，并提供一些便捷的清理技巧，适用于使用python -m build构建的项目。

在过去，通过python setup.py clean --all可以方便地清理使用setup.py构建的项目。然而，随着构建方式的演进，越来越多的项目采用pyproject.toml和python -m build进行构建，而不再依赖setup.py。在这种情况下，我们需要采用新的方法来清理构建过程中产生的临时文件和目录，以保持项目目录的整洁。

以下是一些常见的构建产物，你需要手动识别并删除它们：

__pycache__：Python字节码缓存目录。
*.pyc：Python编译后的字节码文件。
.swp：Vim编辑器创建的交换文件。
build：构建工具（如build）生成的构建目录。
dist：打包工具（如build或setuptools) 生成的发布包目录。

手动清理方法

立即学习“Python免费学习笔记（深入）”；

最直接的方法是手动删除这些文件和目录。可以使用命令行工具或文件管理器来完成这项任务。

示例（命令行）：

rm -rf __pycache__
find . -name "*.pyc" -delete
find . -name ".swp" -delete
rm -rf build
rm -rf dist

登录后复制

这些命令会递归地删除当前目录及其子目录下的__pycache__目录、.pyc文件、.swp文件、build目录和dist目录。

四维时代AI开放平台

查看详情

使用Python脚本清理

为了更方便地清理，可以编写一个Python脚本来自动执行这些删除操作。

示例：

import os
import shutil

def clean_build_files(path="."):
    """
    清理指定路径下的Python构建文件。
    """
    for root, dirs, files in os.walk(path):
        for dir_name in dirs:
            if dir_name == "__pycache__":
                cache_dir = os.path.join(root, dir_name)
                print(f"删除目录: {cache_dir}")
                shutil.rmtree(cache_dir)

        for file_name in files:
            if file_name.endswith(".pyc") or file_name.endswith(".swp"):
                file_path = os.path.join(root, file_name)
                print(f"删除文件: {file_path}")
                os.remove(file_path)

    build_dir = os.path.join(path, "build")
    if os.path.exists(build_dir):
        print(f"删除目录: {build_dir}")
        shutil.rmtree(build_dir)

    dist_dir = os.path.join(path, "dist")
    if os.path.exists(dist_dir):
        print(f"删除目录: {dist_dir}")
        shutil.rmtree(dist_dir)


if __name__ == "__main__":
    clean_build_files() # 清理当前目录
    # clean_build_files("/path/to/your/project") # 清理指定目录

登录后复制

将此脚本保存为clean.py，然后在项目根目录下运行python clean.py即可。

注意事项：