创建仓库

系统基座文件/1/1.4/1.4.2 编译器编排 (Compiler Orchestration).md

@@ -0,0 +1,55 @@
+---
+tags: 
+aliases:
+  - 1.4.2 异构编译器编排策略 (Heterogeneous Compiler Orchestration)
+date created: 星期三, 十一月 19日 2025, 7:27:38 晚上
+date modified: 星期三, 十一月 19日 2025, 7:42:22 晚上
+---
+
+# 1.4.2 异构编译器编排策略 (Heterogeneous Compiler Orchestration)
+
+**审计综述**：
+项目采用了\*\*“Host 主导，Device 旁路”\*\* 的编排模式。通过显式锁定 Host 编译器并禁用 CMake 原生 CUDA 支持，彻底规避了标准 `FindCUDA` 模块在国产异构环境下的兼容性问题。这种配置极其稳健，是当前环境下的最佳实践。
+
+**1. Host 编译器锁定 (Host Compiler Locking)**
+
+  - **关键性**：**P0**
+  - **策略解析**：
+      - **配置**：`set(CMAKE_CXX_COMPILER "/usr/bin/g++")`。
+      - **深度解读**：
+          - **绝对路径**：使用了 `/usr/bin/g++`，消除了 `cc` 或 `c++` 软链接指向不明的风险。
+          - **ABI 锚定**：强制使用系统 GCC，确保了与 OS 内核（GCC 7.3 构建）及系统库（libstdc++）的二进制兼容性。这是混合编译稳定性的基石。
+  - **探测依据**：
+
+    ```cmake
+    set(CMAKE_CXX_COMPILER "/usr/bin/g++")
+    ```
+
+**2. Device 编译器传递 (Device Compiler Passing)**
+
+  - **关键性**：**P1**
+  - **策略解析**：
+      - **配置**：`set(CLANG_CUDA_COMPILER "clang++")`。
+      - **风险提示**：当前配置使用相对命令名。在多编译器共存的环境中（如同时安装了系统 Clang），可能导致误调用。建议优化为 `${COREX_PATH}/bin/clang++` 以实现物理隔离。
+      - **角色**：此变量主要用于后续 `add_custom_command` 或自定义编译规则中，作为处理 `.cu` 文件的专用工具。
+  - **探测依据**：
+
+    ```cmake
+    set(CLANG_CUDA_COMPILER "clang++")
+    ```
+
+**3. 语言标准范围定义 (Language Scope Definition)**
+
+  - **关键性**：**P0**
+  - **策略解析**：
+      - **配置**：`project(SignalProject LANGUAGES CXX)`。
+      - **核心逻辑**：
+          - **仅启用 CXX**：明确告知 CMake 这是一个纯 C++ 项目。
+          - **禁用 CUDA**：`grep "enable_language(CUDA)"` 为空，表明未启用 CMake 的原生 CUDA 支持。
+      - **架构优势**：这避免了 CMake 试图去寻找 NVCC 或执行标准的 CUDA 设备链接（Device Linking）流程，从而让开发者完全掌控智铠 GPU 代码的编译参数（如 `-x ivcore`）。
+  - **探测依据**：
+
+    ```cmake
+    project(SignalProject LANGUAGES CXX)
+    # enable_language(CUDA) -> Not Found
+    ```