启动pipenv即崩溃报错，Python3.10.12+Linux Mint21.2环境求助

问题详情 #

运行环境：Linux Mint 21.2，Python 3.10.12
启动pipenv时直接崩溃，核心报错如下：

Traceback (most recent call last):
  File "/usr/bin/pipenv", line 33, in <module>
    sys.exit(load_entry_point('pipenv==11.9.0', 'console_scripts', 'pipenv')())
  ...
  File "/usr/lib/python3/dist-packages/pipenv/vendor/requests/cookies.py", line 172, in <module>
    class RequestsCookieJar(cookielib.CookieJar, collections.MutableMapping):
AttributeError: module 'collections' has no attribute 'MutableMapping'

尝试通过apt和pip重装pipenv，问题依旧。

问题原因 #

Python 3.10中，collections.MutableMapping已被迁移至collections.abc.MutableMapping。而系统默认安装的pipenv版本（11.9.0）过于老旧，其依赖的requests库仍在使用旧的导入路径，导致兼容性错误。

解决方案 #

1. 彻底卸载旧版pipenv #

• 卸载apt安装的版本：

  sudo apt remove --purge pipenv
  

• 清理pip安装的残留：

  pip uninstall -y pipenv
  

2. 安装兼容Python 3.10的新版pipenv #

通过pip安装最新版（使用--user避免系统权限问题）：

pip install --user pipenv

3. 确保pipenv可全局调用 #

检查用户本地bin目录是否在系统PATH中：

echo $PATH

如果输出中没有~/.local/bin，将其添加到shell配置文件（如~/.bashrc或~/.zshrc）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4. 验证修复 #

运行以下命令确认版本正常：

pipenv --version

此时pipenv应能正常启动，不再出现崩溃报错。

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