使用 setup.py 安装与卸载 Python 包的实操方法

了解 setup.py 的安装逻辑

传统 Python 项目开发中，setup.py 是管理包元数据与安装路径的核心脚本。不同于包管理器自动解析依赖树的方式，它要求开发者在本地环境明确指定源码位置并进行编译或拷贝操作。这种方式非常适合自定义模块的内部部署或临时调试，但同时也意味着安装行为会直接修改当前虚拟环境或系统的全局站点包目录。

安装与清理前的重要前提

在进行源码级操作前，需确保以下条件已满足：

• 本地已配置基础 Python 运行环境。
• 目标项目的根目录下存在正确编写的 setup.py 文件及对应的包结构。
• 终端具有读写当前项目目录及目标安装目录的权限。

第1步：记录安装路径以锁定文件清单

目的：将当前配置好的 Python 包安装至环境中，同时强制命令行记录所创建、修改或覆盖的所有绝对路径，为后续精确卸载做准备。

入口：操作系统终端或集成开发环境内置控制台。

动作与参数：切换至源码所在目录，执行以下命令：

python setup.py install --record files.txt

此处的 --record 是本次操作的关键参数，它会创建一个名为 files.txt 的纯文本文件。每当 setuptools 完成文件复制或软链接建立时，都会将其详细路径追加至该文件中。若终端打印出 Install log file in 'xxx/files.txt'，即表明记录已成功完成。

第2步：批量清空已安装的内容

目的：读取上一步生成的清单，精准剔除每一个由 setup.py 留下的痕迹，恢复纯净的 Python 工作空间。

入口：同一终端窗口。

重要风险警示：xargs 与 rm -rf 属于高强度组合命令，一旦执行将不可逆转地永久删除文件。建议在运行前双击打开 files.txt 审查清单内容，确保没有误录其他关键系统的配置文件。如有可能，请先对项目根目录做一次简单备份。

执行清理：

cat files.txt | xargs rm -rf

上述命令适用于 Linux 及 macOS 等类 Unix 系统。其原理是先调用 cat 打印文件流，再通过管道 | 输送给 xargs，由后者自动生成连续的删除参数交给 rm -rf 执行。
若您使用的是 Windows 操作系统，原生不支持此语法，可改用 PowerShell 实现相同效果：

Get-Content files.txt | ForEach-Object { Remove-Item $_ -Force }

验证卸载是否彻底

清理完成后，可通过查看 Python 交互环境中的 sys.path 或通过 import 你的包名 来尝试调用。如果之前正常导入的模块此刻抛出 ModuleNotFoundError，说明残留文件已被完全清除。再次打开 files.txt，此时文件内部应当已被清空或报错不存在。

简要总结

掌握利用 --record 参数追踪安装文件的方法是本地化 Python 开发的必备技能。相比人工肉眼排查杂乱的路径，这种自动化记录的思路能够极大提升环境切换与版本回退的效率。以上内容整理了 setup.py 常规使用的操作规范与排错要点，更多关于 Python 环境管理与依赖部署的技术资料请关注本站其它相关文章！