安装Pyinstaller时出现No module named 'fcntl'错误求助

原因分析 #

fcntl是Linux/Unix系统专属的系统调用模块，Windows环境下的Python默认不会包含这个模块。你遇到的错误说明安装过程中触发了依赖Linux模块的逻辑，大概率是环境配置或包管理环节出了问题。

解决方法 #

• 确认使用Windows版Python
  检查当前Python是否为Windows原生版本：打开命令行输入python --version，查看输出的路径是否指向Windows系统内的Python安装目录（比如C:\Python311\python.exe）。如果是WSL（Windows子系统Linux）里的Python，会默认依赖Linux库，自然找不到fcntl。

• 升级pip和相关工具
  旧版本的包管理工具可能导致依赖解析错误，先执行升级：

  python -m pip install --upgrade pip setuptools wheel
  

• 清理缓存后重新安装
  缓存的损坏文件可能引发异常，清理后重新安装：

  pip cache purge
  pip install pyinstaller --no-cache-dir
  

• 使用全新虚拟环境安装
  现有环境中的第三方库可能干扰安装流程，创建干净的虚拟环境尝试：

  python -m venv py_env
  py_env\Scripts\activate
  pip install pyinstaller
  

• 指定稳定版本安装
  部分新版本可能存在兼容性问题，可尝试安装已知稳定的版本：

  pip install pyinstaller==5.13.2
  

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