使用pypcie时遇ImportError：无法从mmap导入PROT_READ

问题描述 #

在VS Code中通过pip安装pypcie包后，运行代码时触发导入错误，具体报错如下：

Traceback (most recent call last):
  File "c:\Users\'user'\OneDrive\desktop\Git Repos\learnpython_org\pyPCIE_playground.py", line 2, in <module>
    from pypcie import Device
  File "C:\Users\'user'\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\pypcie\_init_.py", line 1, in <module>
    from .device import Device
  File "C:\Users\'user'\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\pypcie\device.py", line 3, in <module>
    from .bar import Bar
  File "C:\Users\'user'\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\pypcie\bar.py", line 3, in <module>
    from mmap import mmap, PROT_READ, PROT_WRITE, PAGESIZE
ImportError: cannot import name 'PROT_READ' from 'mmap' (unknown location)

问题根源是pypcie包的bar.py文件中使用了这行导入代码：

from mmap import mmap, PROT_READ, PROT_WRITE, PAGESIZE

尝试执行pip install mmap时，系统返回Could not find a version that satisfies the requirement mmap——这是因为mmap是Python内置模块，无需通过pip安装。

原因与解决办法 #

• 核心原因：PROT_READ、PROT_WRITE、PAGESIZE是Unix/Linux系统专属的mmap模块常量，Windows系统的Python内置mmap并不包含这些内容。pypcie包主要针对Unix/Linux环境开发，未做Windows兼容处理。

• 可行解决路径：

  1. 切换至Linux环境运行：如果条件允许，在Ubuntu、CentOS等Linux系统下部署Python和pypcie包，即可正常导入这些常量并使用功能。
  2. 修改pypcie源码适配Windows：
     • 找到pypcie包的安装路径（比如报错信息中的C:\Users\'user'\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\pypcie\bar.py）
     • 打开bar.py文件，将原导入语句替换为：

       from mmap import mmap
       # 手动定义Windows环境下的替代常量
       PROT_READ = 1
       PROT_WRITE = 2
       PAGESIZE = 4096  # Windows系统默认页面大小通常为4KB，可根据实际情况调整
       

     • 保存修改后重新运行代码，但需注意：这种修改仅能解决导入问题，pypcie底层的PCIe内存映射逻辑可能和Windows系统不兼容，后续功能可能无法正常工作。

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