### 使用 `setuptools` 配置 Python 包及 C++ 扩展模块 #### 设置基础环境 为了创建一个能够调用 C++ 代码的 Python 包，首先需要准备开发环境中必要的工具链和支持库。这通常意味着要安装适合操作系统的编译器以及 Python 开发头文件。 对于 Linux 用户来说，可以通过包管理器获取这些依赖项；而在 Windows 上，则可能需要用到 Microsoft Visual Studio 或 MinGW-w64 工具集[^1]。 #### 创建项目结构 合理的项目布局有助于简化构建过程中的路径管理和资源定位工作。推荐采用如下所示的标准目录树： ``` my_project/ ├── my_extension/ │ ├── __init__.py │ └── module.cpp # C++ 源码位置 └── setup.py # 构建脚本所在处 ``` 其中 `module.cpp` 是待封装成 Python 可访问形式的目标 C++ 文件之一。 #### 编写 Setup Script (`setup.py`) 接下来，在根目录下编辑或新建名为 `setup.py` 的 Python 脚本来定义项目的元数据和构建指令。这里展示了一个简单的例子用于说明如何通过 `Extension` 类型对象声明外部链接至 C/C++ 实现的功能接口，并利用 `find_packages()` 函数自动发现子包内的组件[^3]。 ```python from setuptools import setup, Extension, find_packages ext_modules = [ Extension( name="my_package.my_extension", sources=["./my_extension/module.cpp"], include_dirs=[], libraries=[], extra_compile_args=['-std=c++11'], language='c++' ) ] setup( name='MyProject', version='0.1dev', packages=find_packages(), ext_modules=ext_modules, ) ``` 注意上述代码片段中对 `include_dirs`, `libraries` 参数留空是因为具体值取决于实际使用的第三方库情况——如果有的话。另外还指定了 `-std=c++11` 来启用现代标准特性支持。 #### 添加额外的数据文件夹 当希望随同发布版一起分发某些非源代码性质的内容（比如文档、测试样例等），可以借助于 `package_data` 字典参数来指示哪些相对路径下的文件应该被打包进去。下面的例子展示了怎样让整个 `data/` 子目录都被纳入最终产物之中[^2]。 ```python import os.path as osp this_directory = osp.abspath(osp.dirname(__file__)) with open(osp.join(this_directory, 'README.md'), encoding='utf-8') as f: long_description = f.read() setup( ... package_data={ '': ['*.txt', '*.rst'], # 这里可以根据实际情况调整通配符模式 'my_package': [osp.join('..', 'data', '*')] }, include_package_data=True, ... ) ``` > **提示**: 如果遇到找不到指定路径的问题，请确认当前工作区确实位于顶层源码仓库内，并且所给出的是相对于该点而言的有效地址表达方式。 #### 完整流程概述 综上所述，完成一次完整的基于 `setuptools` 和 C++ 的混合编程实践大致遵循以下逻辑顺序： - 设计清晰的应用架构图； - 细化各个组成部分的具体职责范围； - 根据需求挑选合适的算法模型和技术栈组合； - 小步迭代地实现功能原型直至满足预期效果； - 形成稳定版本后按照前述指导方针整理好所有必要材料； - 发布前务必经过充分验证以确保兼容性和稳定性。