通过Homebrew安装的virtualenv突发filelock模块缺失故障

我通过Homebrew安装了Python 3.12和virtualenv 20.25.0，此前使用virtualenv功能正常，但再次使用时执行virtualenv --version命令出现如下报错：

$ virtualenv --version
Traceback (most recent call last):
  File "/usr/local/bin/virtualenv", line 5, in <module>
    from virtualenv.__main__ import run_with_catch
  File "/usr/local/lib/python3.12/site-packages/virtualenv/__init__.py", line 3, in <module>
    from .run import cli_run, session_via_cli
  File "/usr/local/lib/python3.12/site-packages/virtualenv/run/__init__.py", line 7, in <module>
    from virtualenv.app_data import make_app_data
  File "/usr/local/lib/python3.12/site-packages/virtualenv/app_data/__init__.py", line 11, in <module>
    from .read_only import ReadOnlyAppData
  File "/usr/local/lib/python3.12/site-packages/virtualenv/app_data/read_only.py", line 5, in <module>
    from virtualenv.util.lock import NoOpFileLock
  File "/usr/local/lib/python3.12/site-packages/virtualenv/util/lock.py", line 12, in <module>
    from filelock import FileLock, Timeout
ModuleNotFoundError: No module named 'filelock'

可能的故障原因 #

• 依赖包意外缺失：virtualenv运行依赖filelock包，可能因为系统自动清理缓存、Homebrew更新Python时误删关联依赖，或者磁盘临时错误导致该包的文件损坏/丢失——即使你没主动操作，后台的包管理维护进程也可能触发这类变动。
• Python环境路径冲突：Homebrew安装的Python可能存在多版本共存情况，某次隐性的环境变量变更（比如终端配置文件意外重载），导致调用virtualenv时实际指向的Python环境和安装virtualenv的环境不一致，当前环境中未安装filelock。
• virtualenv安装损坏：磁盘写入错误、系统进程异常终止等偶发问题，可能导致virtualenv的安装文件部分损坏，无法正确加载依赖的filelock模块。

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