使用自定义Python包时出现pkg_resources.VersionConflict版本冲突问题

该版本冲突报错的核心是运行流程中存在强制要求texterrors==0.0.2的锁定逻辑，和第三方依赖声明无关，按优先级依次排查：

1 排查命令行入口脚本硬编码（最高概率） #

• 执行which texterrors（Linux/macOS）或where texterrors（Windows）获取当前调用的可执行文件路径
• 打开该文件查看头部是否存在__requires__ = 'texterrors==0.0.2'这类硬编码版本声明，这是旧版本安装时生成的入口残留，卸载包不会自动删除该文件
• 解决方法：直接删除该入口文件，重新安装0.0.4版本的texterrors即可自动生成适配的新入口

2 验证包本身安装状态 #

执行以下命令验证包导入逻辑：

python -c "import texterrors; print(texterrors.__version__)"

• 若正常输出0.0.4，说明包本身安装无问题，问题完全来自入口脚本残留，执行第一步的解决方法即可
• 若仍报版本冲突，继续后续排查

3 排查包配置与业务代码的隐式锁定 #

• 检查texterrors包的配置文件（pyproject.toml、setup.py、setup.cfg），确认依赖声明字段没有错误写入texterrors==0.0.2的自身依赖
• 排查你调用该包的业务代码，是否存在pkg_resources.require("texterrors==0.0.2")这类主动指定版本的语句

4 排查环境层面的残留配置 #

• 检查是否使用过pipx、conda等隔离工具安装过旧版本texterrors，隔离环境的旧入口会优先被调用
• 排查全局pip配置目录下的隐式依赖锁定，比如~/.pip/requirements.txt、~/.config/pip/pip.conf中的自定义安装要求

内容的提问来源于stack exchange，提问作者Nimitz14