使用Cython编译Python模块时链接器报错的问题求助

问题重现 #

代码文件 #

setup.py内容：

from setuptools import setup
from Cython.Build import cythonize
setup(ext_modules=cythonize('picmanager.pyx', language_level=311))

初始编译错误 #

执行python setup.py build后报错：

(venv) D:\pythonProject2> python setup.py build
running build
running build_ext......
  Creating library build\temp.win-amd64-cpython-311\Release\picmanager.cp311-win_amd64.lib and object build\temp.win-amd64-cpython-311\Release\picmanager.cp311-win_amd64.exp
MSVCRT.lib(dll_dllmain.obj) : error LNK2001: 无法解析的外部符号 _initterm......(省略剩余28条)
build\lib.win-amd64-cpython-311\picmanager.cp311-win_amd64.pyd : fatal error LNK1120: 29 个无法解析的外部命令
error: command 'D:\Program Files (x86)\BuildTools\VC\Tools\MSVC\14.37.32822\bin\HostX86\x64\link.exe' failed with exit code 1120

修改环境变量后的错误 #

添加CRT环境变量指向MSVC和Windows Kits的源码目录后，报错变为：

MSVCRT.lib(utility.obj) : error LNK2001: 无法解析的外部符号 _configure_narrow_argv
MSVCRT.lib(utility.obj) : error LNK2001: 无法解析的外部符号 _initialize_narrow_environment
build\lib.win-amd64-cpython-311\picmanager.cp311-win_amd64.pyd : fatal error LNK1120: 2 个无法解析的外部命令

解决建议 #

• 移除手动添加的CRT环境变量：你添加的CRT变量指向的是CRT源码目录，而链接器需要的是编译好的.lib库文件，不是源码。该变量会干扰MSVC的路径解析逻辑，删除后重启终端重试编译。
• 使用正确的MSVC命令行环境：打开x64 Native Tools Command Prompt for VS 2022，激活虚拟环境后再执行编译命令，工具链会自动配置正确的INCLUDE、LIB等环境变量，避免手动配置出错。
• 显式指定CRT链接方式：修改setup.py，通过编译参数指定静态或动态链接CRT，避免版本冲突：

  from setuptools import setup
  from Cython.Build import cythonize
  from setuptools.extension import Extension
  
  ext = Extension(
      "picmanager",
      sources=["picmanager.pyx"],
      extra_compile_args=["/MT"],  # 静态链接CRT，可选/MD动态链接
      language_level=311
  )
  
  setup(ext_modules=cythonize(ext))
  

• 清理编译缓存：删除build目录、生成的picmanager.c文件，重新执行编译命令，避免旧产物干扰。
• 检查pyx文件依赖：如果picmanager.pyx调用了外部C/C++库，需在Extension中添加library_dirs和libraries参数，指定库路径和名称，确保链接器能找到对应符号。

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