跨目录Cython cimport失败求助：从dut编译cpysim模块文件

我之前也碰到过几乎一模一样的跨目录Cython模块引用坑，结合你的尝试和Cython的文件查找逻辑，给你几个针对性的解决方案：

1. 先把cpysim变成合法的Cython包 #

你已经给cpysim加了__init__.py，但Cython识别包还需要额外的文件支持：

• 在cpysim目录下创建__init__.pxd（可以是空文件，或者声明你想对外导出的类型/函数），这是Cython把它当成可cimport包的关键——只靠__init__.py不足以让Cython处理cimport cpysim.sim_core这类语句。

2. 调整setup_dut.py的配置 #

Cython查找.pxd文件和C编译器找头文件是两套独立逻辑，你设置的include_dirs是给C编译器用的，得给Cython单独指定查找路径，同时确保Python能定位到cpysim包：

import sys
from pathlib import Path
from setuptools import setup, Extension
from Cython.Build import cythonize

# 把cpysim所在的父目录加入Python路径，让Cython能识别cpysim包
sys.path.append(str(Path(__file__).parent.parent))

extensions = [
    Extension(
        "dut.your_target_module",  # 替换成你要编译的dut模块名
        sources=["path/to/your/dut_module.pyx"],
        include_dirs=["../cpysim"],  # 保留你原有给C编译器找.h头文件的配置
    )
]

# 给cythonize指定include_path，让Cython能找到cpysim里的.pxd文件
setup(
    name="dut",
    ext_modules=cythonize(extensions, include_path=["../cpysim"])
)

3. 修正cimport语句 #

完成上面两步后，两种cimport写法都能生效：

• 写法一（作为包引用）：cimport cpysim.sim_core as sim_core，前提是cpysim目录有__init__.pxd且父目录已加入sys.path
• 写法二（直接引用模块）：from sim_core cimport sigtype_t，前提是cythonize的include_path包含了../cpysim，让Cython能直接定位到sim_core.pxd

额外检查点 #

• 确认你的目录结构符合预期（避免路径错位）：

  项目根目录/
  ├── cpysim/
  │   ├── __init__.pxd
  │   ├── sim_core.pxd
  │   └── wiretypes.pyx
  └── dut/
      ├── setup_dut.py
      └── 你的待编译模块.pyx
  

• 编译时尽量在dut目录下运行python setup_dut.py build_ext --inplace，减少路径匹配问题

内容的提问来源于stack exchange，提问作者Colin Weltin-Wu