Windows10 64位下pip安装record3d失败：无法构建wheel及CMake错误

问题背景 #

正在实现手机到PC的LiDAR数据流式传输，在Windows10 64位系统的VSCode中执行pip install record3d时安装失败。

环境信息 #

• Windows10 64位
• VSCode
• Python 3.10，numpy 1.26.0已安装

报错详情 #

执行pip install record3d后出现以下错误：

C:\Users\aboud>pip install record3d
Collecting record3d
  Using cached record3d-1.3.1-2.tar.gz (548 kB)
  Preparing metadata (setup.py) ... done
Requirement already satisfied: numpy in c:\users\aboud\appdata\local\programs\python\python310\lib\site-packages (from record3d) (1.26.0)
Building wheels for collected packages: record3d
  Building wheel for record3d (setup.py) ... error
  error: subprocess-exited-with-error
  
  × python setup.py bdist_wheel did not run successfully.
  │ exit code: 1
  ╰─> [63 lines of output]
      running bdist_wheel
      running build
      running build_ext
      C:\Users\aboud\AppData\Local\Temp\pip-install-3wai_i0f\record3d_39f6a6e1cbff41099e3ee8d64013c385\setup.py:29: DeprecationWarning: distutils Version classes are deprecated. Use packaging.version instead.
        cmake_version = LooseVersion(re.search(r'version\s*([\d.]+)', out.decode()).group(1))
      -- Building for: NMake Makefiles
      CMake Error at CMakeLists.txt:2 (project):
        Generator
     
          NMake Makefiles
     
        does not support platform specification, but platform
     
          x64
     
        was specified.
     
     
      CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
      CMake Error: CMAKE_CXX_COMPILER not set, after EnableLanguage
      -- Configuring incomplete, errors occurred!

解决步骤 #

1. 安装C/C++编译工具链 #

报错核心是缺少C/C++编译器，且CMake默认使用的NMake生成器不支持x64平台指定。安装Visual Studio Build Tools：

• 下载Visual Studio Installer，勾选「Desktop development with C++」组件，确保包含MSVC编译器、Windows SDK等核心工具。
• 安装完成后重启终端或VSCode，让环境变量生效。

2. 指定兼容的CMake生成器 #

手动设置CMake使用支持x64的生成器，比如对应Visual Studio 2022的生成器：
在终端执行：

set CMAKE_GENERATOR="Visual Studio 17 2022 Win64"

之后再运行pip install record3d。

3. 尝试预编译轮子安装（备选） #

如果编译仍有问题，可直接使用预编译的wheel包：

• 确认你的Python版本（3.10）和系统架构（x64），找到对应版本的record3d wheel文件，用pip install 文件名.whl直接安装。

4. 更新CMake版本 #

检查当前CMake版本：

cmake --version

若版本过低，去CMake官网下载安装最新版，并将其添加到系统PATH中。

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