我之前也遇到过类似的需求——希望用户卸载包时能妥善清理生成的配置目录，虽然pip本身没有原生支持卸载后执行自定义脚本的机制，但有几个实用的方案可以实现这个目标：

方案一：提供手动清理的控制台命令（最推荐，跨平台且可靠） #

这是最稳妥的方式，既符合pip的设计逻辑，又能给用户自主选择的权利（毕竟有些用户可能想保留配置文件用于后续重装）。

1. 在你的包代码中添加一个清理函数，比如在my_package/__init__.py里：

import os
import shutil

def cleanup_config():
    # 替换成你的config文件夹实际路径
    config_dir = os.path.expanduser("~/.my-package/config")
    if os.path.exists(config_dir):
        shutil.rmtree(config_dir)
        print(f"已清理配置目录: {config_dir}")
    else:
        print("配置目录不存在，无需清理")

2. 在包的配置文件中注册控制台脚本入口：

• 如果用传统的setup.py：

from setuptools import setup

setup(
    # ... 你的其他包配置信息（名称、版本、依赖等）
    entry_points={
        'console_scripts': [
            'clean-my-package-config=my_package:cleanup_config',
        ],
    },
)

• 如果用符合PEP 621的pyproject.toml（推荐）：

[project.scripts]
clean-my-package-config = "my_package:cleanup_config"

3. 在包的README或使用文档中添加说明，告诉用户卸载后如果需要清理配置文件，可以运行：

clean-my-package-config

方案二：自定义卸载命令（适合愿意用专属命令卸载的用户） #

如果你希望用户通过一个命令完成「卸载+清理」的一站式操作，可以在setup.py中定义一个自定义卸载命令：

from setuptools import setup, Command
import subprocess
import os
import shutil

class UninstallAndCleanCommand(Command):
    description = "卸载包并同步清理用户配置目录"
    user_options = []

    def initialize_options(self):
        pass

    def finalize_options(self):
        pass

    def run(self):
        # 调用pip完成包卸载
        subprocess.run(["pip", "uninstall", "-y", "my-package"], check=True)
        # 清理配置目录
        config_dir = os.path.expanduser("~/.my-package/config")
        if os.path.exists(config_dir):
            shutil.rmtree(config_dir)
            print(f"已清理配置目录: {config_dir}")

setup(
    # ... 其他配置
    cmdclass={
        'uninstall_clean': UninstallAndCleanCommand,
    },
)

用户只需运行以下命令就能完成卸载+清理：

python setup.py uninstall_clean

不过要注意，这个方案要求用户使用该自定义命令卸载，而非直接用pip uninstall，需要在文档中明确说明。

方案三：自动清理的hack方式（不推荐，兼容性差） #

如果你非常想实现自动清理，有个不太优雅的思路：在包安装时创建定时任务，定期检查包是否还存在于site-packages中，若不存在则删除配置目录。但这个方法跨平台实现复杂（Windows用计划任务、Linux/macOS用cron），且可能给用户带来意外的清理操作，因此不推荐使用。

总结 #

最推荐方案一，既简单可靠，又尊重用户的选择权。只要在文档中清晰说明清理命令，用户就能轻松处理残留的配置目录。

内容的提问来源于stack exchange，提问作者Maël Pedretti