Slang 编译器内部样板代码生成工具slang-generate深入解析【免费下载链接】slangMaking it easier to work with shaders项目地址: https://gitcode.com/GitHub_Trending/sl/slangslang-generate是 Slang 着色器语言编译器仓库内置的一款样板代码生成工具Boilerplate Code Generation Tool它位于 tools/slang-generate 目录负责在编译器构建过程中把以.meta.slang/.meta.cpp编写的模板文件展开为可直接编译进编译器二进制中的 C 头文件。本文将以该工具的官方说明文档tools/slang-generate/README.md为主线结合 main.cpp 的完整实现与 source/slang-core-module/CMakeLists.txt 的构建集成系统讲解它的定位、模板语法、命令行用法、代码生成机制与增量输出策略。读完本文你将理解 Slang 编译器标准库源码即模板的构建理念并掌握这套模板生成器的工作方式能够在自己的项目里复现类似的元编程代码生成管线。工具定位为什么编译器内部需要代码生成器官方 README 对它的定义只有一句话This directory contains the implementation of theslang-generatetool used to generate boilerplate code inside of the compiler implementation.即slang-generate是用于在编译器实现内部生成样板代码的工具。这里的样板代码并非指普通的外部脚手架而是编译器标准库core module的 C 侧表示——Slang 编译器的大量内建类型、内建函数、语法修饰符声明都以 Slang 语言本身写在.meta.slang模板文件中构建时由本工具转换成 C 头文件再被编译器源码#include。仓库中的模板文件就是这一机制的直接证据位于 source/slang 目录core.meta.slang核心模块约 5500 行声明基础类型别名、syntax修饰符、内建泛型与语法糖等hlsl.meta.slangHLSL 相关内建与转换规则glsl.meta.slangGLSL 相关内建diff.meta.slang自动微分相关的内建支持。与slang-generate同属一个思想阵营的还有能力定义生成工具slang-capabilities.capdef文件的开头注释明确写道该文件是 Slang 语言所支持全部能力的单一事实来源single source of truth由slang-capability-generator工具在构建期解析并产出slang-generated-capability-defs.h与slang-generated-capability-defs-impl.h见 source/slang/slang-capabilities.capdef。这套以源文件为真源、构建期生成 C 代码的模式贯穿整个编译器工程。构建集成CMake 如何驱动 slang-generateslang-generate并非手动运行的辅助脚本而是构建系统的正式环节。在 source/slang-core-module/CMakeLists.txt 中可以看到完整的集成方式# 收集所有 *.meta.slang 模板 set(core_module_meta_source_dir ${slang_SOURCE_DIR}/source/slang) glob_append(core_module_meta_source ${core_module_meta_source_dir}/*.meta.slang) # 生成目录 set(core_module_meta_output_dir ${CMAKE_CURRENT_BINARY_DIR}/core-module-meta) # 由每个模板推导出目标头文件列表 # 例如 core.meta.slang - core.meta.slang.h foreach(meta_source ${core_module_meta_source}) file(RELATIVE_PATH meta_source_relative ${core_module_meta_source_dir} ${meta_source}) list(APPEND core_module_meta_generated_headers ${core_module_meta_output_dir}/${meta_source_relative}.h) endforeach() add_custom_command( OUTPUT ${core_module_meta_generated_headers} COMMAND ${CMAKE_COMMAND} -E make_directory ${core_module_meta_output_dir} COMMAND slang-generate ${core_module_meta_source} --target-directory ${core_module_meta_output_dir} DEPENDS ${core_module_meta_source} slang-generate WORKING_DIRECTORY ${core_module_meta_source_dir} VERBATIM )由此可以得到几个关键的工程事实输入是source/slang/下全部*.meta.slang文件输出目录为构建目录下的core-module-meta/输出命名规则每个输入文件name.meta.slang对应生成name.meta.slang.h生成逻辑见下文命令行一节生成的头文件随后被编译进slang-embedded-core-module-source等目标成为编译器二进制的一部分同一 CMakeLists 的 78–84 行将该目标EXPLICIT_SOURCE指定为这些生成头。这些生成产物会被编译器核心源码直接引用例如 source/slang/slang-capability.cpp 的#include slang-generated-capability-defs-impl.h、source/slang/slang-capability.h 与 source/slang/slang-compiler-options.h 的 include都是从源文件声明 → 工具生成 → 编译器使用链条下游的真实消费者。命令行接口与参数解析main.cpp中usage()函数给出了工具的命令行形态main.cppusage: slang-generate [FILE]... [--target-directory FILE]即一个或多个输入文件外加一个可选的--target-directory输出目录。参数解析逻辑位于main()开头main.cpp依次扫描argv遇到--target-directory时读取其下一个参数作为输出目录并通过Path::simplify归一化路径其余参数一律视为输入文件路径同样经过Path::simplify——源码注释特别说明这一简化会把路径分隔符统一为/从而保证后续在生成的代码里输出路径时结果正确如果没有任何输入文件直接打印 usage 并退出返回码 1。输出文件的最终路径按两种情形决定main.cppif (outputDir.getLength()) outputPathFinal outputDir / Slang::Path::getFileName(inputPath) .h; else outputPathFinal inputPath .h;指定了--target-directory时输出目录/输入文件名.h未指定时直接在输入文件同名基础上追加.h即core.meta.slang.h紧挨着core.meta.slang生成。输入文件的分类与解析策略slang-generate并不会对所有输入一视同仁而是按扩展名选择处理方式。parseSourceFile中维护了一张分派表main.cpp扩展名处理方式说明.meta.slangparseTemplateFile按模板语法完整解析生成代码.meta.cppparseTemplateFile同样作为模板解析.cppparseCxxFile目前只预留了从源文件抓取元数据的 TODO实际返回nullptr不处理其他parseUnknownFile不处理解析器把整个文件读入内存后交由readBodyfalse以文档级视角扫描openChar/closeChar取-2意味着顶层扫描不受括号配对约束只是逐字符识别模板指令main.cpp。模板语法text / splice / escape 三种节点整个模板模型建立在一种简单的**节点链表Node 链**之上。Node结构main.cpp只有三种Flavortext需要原样写入输出的普通文本escape元级代码语句其body是子节点链表splice元级表达式结果将被拼接到输出中。模板文件就是文本 少量$指令的混合体。解析器readBodymain.cpp遇到$时根据紧随其后的字符分派到不同的语法形式。1. 表达式插入$(表达式)当$后紧跟(时表示一个表达式 splicemain.cpp$(expr)解析器先终结前一段文本节点然后调用readBodytrue(reader, 0, (, 0, ))递归读取括号体并创建splice节点之后继续收集后续文本。这里的模板参数onlyReadFirstOpenChar true有一个非常实际的用途——源码注释明确说明main.cpp它允许myFunc($((int)val))这种写法被正确解析。如果一次性吞掉所有连续的(括号体会被错误截成int)val导致后续出现难以察觉的段错误。2. 块级转义${...}...$}当$后紧跟{时进入块结构转义block-structured escape以$}收尾main.cpp${ 这里是元级代码 }其中内容被收集为escape节点的 body。注意该块与 C 风格花括号无关终止条件只看$}组合。3. 行级语句转义行首$:当$出现在行首且后跟:时这是一条语句转义statement escape持续到本行行尾main.cpp$: 一条元级语句实现上$前从lineBegin起的文本被终结为 text 节点冒号后的内容包括行尾换行整体作为escape节点。也就是说这种形式让开发者可以在模板里按行嵌入控制逻辑。4. 语句插入行首$identifier当$出现在行首且后跟标识符字符时属于语句插入statement splicemain.cpp。它支持类似下面的写法$T0::SomeTypeDefine源码注释解释了为何需要这个语法main.cpp在 C/CUDA 目标下(SomeTemplate...::SomeTypeDefine)这种给类型表达式加括号的写法是不合法的因此模板生成器需要一种不依赖括号的语句插入形式。解析时它会消费一个可选标识符、可选水平空白、可选的()包裹块只保留最外层以及{前的可选空白/换行。5. 普通$的处理如果$后跟的字符不属于以上任何情况则视为输出中的字面$main.cpp不会当作指令。其他细节空白与换行解析器区分水平空白空格、制表符与换行\r\n组合通过handleNewline折叠处理main.cpp保证 Windows/Linux 行尾在模板与输出中行为一致括号配对对$(...)这类单字符开闭的体内部遇到(/)会维护depth计数只有深度回到 0 时才认为体结束main.cpp因此$(内部允许嵌套圆括号。输出机制生成什么形式的 C 代码解析得到的节点链表通过emitTemplateNodes产出最终代码main.cpp。三种节点的发射策略各不相同text 节点发射为SLANG_RAW(...)宏调用其中的换行、制表符、引号、反斜杠等一律转义为字符串字面量形式转义细节见emitStringLiteralTextmain.cppsplice 节点发射为SLANG_SPLICE(...)宏调用参数为节点的原始代码escape 节点直接展开其 body 的代码emitCodeNodesmain.cpp。也就是说模板文件最终被翻译成一系列SLANG_RAW(...)/SLANG_SPLICE(...)宏调用的 C 序列这些宏由生成头文件的上游消费方按需定义展开。emitRawmain.cpp还展示了另一种文本发射路径逐字符把文本转换为sb ...形式的流式拼接语句并把换行拆成\n;换行后继续sb 的连续语句。一个值得注意的设计是#line指令的自动插入main.cppemitTemplateNodes预先用StringUtil::calcLines建立源文件的行断点索引当节点序列从escape过渡回text时用二分查找_findLineIndexmain.cpp定位该文本在模板源文件中的行号并发射SLANG_RAW(#line N \文件名\)这样即便代码是由模板展开生成的编译器在报告错误、打印诊断时也能把行号映射回原始的.meta.slang模板文件路径使用Path::getFileName得到的纯文件名见 main.cpp大幅提升可调试性。增量输出只在内容变化时落盘写文件环节同样经过精心设计main.cpp先把展开结果写入临时文件输入路径.temp.h计算最终输出路径带或不带--target-directory读取最终目标文件的旧内容与新临时文件内容进行比较仅当新旧内容不一致时才覆盖写入最终文件writeAllText失败时报G0001错误无论是否写入最后都删除临时文件。这一先写临时文件、再比对、后替换的策略带来了两个实际收益构建期内重复执行生成命令不会无谓地触碰文件时间戳避免下游不必要的重编译且只有真正发生内容变化时才触发依赖重编译。实战视角模板文件长什么样理解了语法与机制后再看真实模板会更容易建立直觉。以核心模块 core.meta.slang 为例它以一个public module core;声明开头随后用 Slang 语言本身声明编译器需要的内建实体例如基础类型别名typedef half float16_t; typedef float float32_t; typedef double float64_t; typedef int int32_t; typedef uint uint32_t; typedef uintptr_t size_t; typedef uintptr_t usize_t;以及语法修饰符的声明syntax modifier例如syntax constexpr : ConstExprModifier; syntax globallycoherent : GloballyCoherentModifier;这些声明被slang-generate展开为 C 头文件后编译器的前端AST 构造、语义检查等便可以在 C 侧引用这些内建实体——例如 source/slang/slang-ast-builder.cpp 提到core.meta.slang、hlsl.meta.slang等模板文件最终都归入同一个Core模块source/slang/slang-check-conversion.cpp 也直接引用了core.meta.slang中声明的__EnumType等内建类型。这意味着标准库的源码就是模板编译器自身的 C 表示由模板驱动生成避免了手写两份定义带来的漂移风险。同样地能力capability体系的维护也遵循只改源文件、不碰生成文件的约定slang-capabilities.capdef注释明确要求新增能力时编辑该文件而非生成的头文件source/slang/slang-capabilities.capdef。小结一套可复用的构建期元编程管线slang-generate虽小单文件实现约 966 行 C但它完整承载了 Slang 编译器以元模板为真源的代码生成哲学模板语法极简但够用textescapesplice三种节点配合$(...)、${...}、行首$:、行首$identifier四类指令即可在普通文本中嵌入任意元级逻辑输出即 C模板被翻译为SLANG_RAW/SLANG_SPLICE宏序列并在 escape→text 边界自动插入#line指令保证生成代码的可诊断性工程友好支持--target-directory、路径归一化、\r\n兼容、临时文件比对后的增量写入与 CMake 的add_custom_command无缝配合闭环消费core.meta.slang等模板生成的头文件被编译进slang-embedded-core-module-source进而由slang-capability.cpp、slang-compiler-options.h等编译器核心源码直接 include完成从Slang 语言声明到编译器 C 内建的自动化闭环。如果你正在阅读 Slang 编译器源码source/slang/*.meta.slang与其构建产物是最值得对照阅读的一对输入输出如果你想在自研编译器中落地类似方案slang-generate的节点链表模型、#line映射与增量写入策略都是可以直接借鉴的成熟设计。【免费下载链接】slangMaking it easier to work with shaders项目地址: https://gitcode.com/GitHub_Trending/sl/slang创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/20 2:38:40 · 阅读 1.2k Slang 编译器内部样板代码生成工具 `slang-generate` 深入解析
Slang 编译器内部样板代码生成工具slang-generate深入解析【免费下载链接】slangMaking it easier to work with shaders项目地址: https://gitcode.com/GitHub_Trending/sl/slangslang-generate是 Slang 着色器语言编译器仓库内置的一款样板代码生成工具Boilerplate Code Generation Tool它位于 tools/slang-generate 目录负责在编译器构建过程中把以.meta.slang/.meta.cpp编写的模板文件展开为可直接编译进编译器二进制中的 C 头文件。本文将以该工具的官方说明文档tools/slang-generate/README.md为主线结合 main.cpp 的完整实现与 source/slang-core-module/CMakeLists.txt 的构建集成系统讲解它的定位、模板语法、命令行用法、代码生成机制与增量输出策略。读完本文你将理解 Slang 编译器标准库源码即模板的构建理念并掌握这套模板生成器的工作方式能够在自己的项目里复现类似的元编程代码生成管线。工具定位为什么编译器内部需要代码生成器官方 README 对它的定义只有一句话This directory contains the implementation of theslang-generatetool used to generate boilerplate code inside of the compiler implementation.即slang-generate是用于在编译器实现内部生成样板代码的工具。这里的样板代码并非指普通的外部脚手架而是编译器标准库core module的 C 侧表示——Slang 编译器的大量内建类型、内建函数、语法修饰符声明都以 Slang 语言本身写在.meta.slang模板文件中构建时由本工具转换成 C 头文件再被编译器源码#include。仓库中的模板文件就是这一机制的直接证据位于 source/slang 目录core.meta.slang核心模块约 5500 行声明基础类型别名、syntax修饰符、内建泛型与语法糖等hlsl.meta.slangHLSL 相关内建与转换规则glsl.meta.slangGLSL 相关内建diff.meta.slang自动微分相关的内建支持。与slang-generate同属一个思想阵营的还有能力定义生成工具slang-capabilities.capdef文件的开头注释明确写道该文件是 Slang 语言所支持全部能力的单一事实来源single source of truth由slang-capability-generator工具在构建期解析并产出slang-generated-capability-defs.h与slang-generated-capability-defs-impl.h见 source/slang/slang-capabilities.capdef。这套以源文件为真源、构建期生成 C 代码的模式贯穿整个编译器工程。构建集成CMake 如何驱动 slang-generateslang-generate并非手动运行的辅助脚本而是构建系统的正式环节。在 source/slang-core-module/CMakeLists.txt 中可以看到完整的集成方式# 收集所有 *.meta.slang 模板 set(core_module_meta_source_dir ${slang_SOURCE_DIR}/source/slang) glob_append(core_module_meta_source ${core_module_meta_source_dir}/*.meta.slang) # 生成目录 set(core_module_meta_output_dir ${CMAKE_CURRENT_BINARY_DIR}/core-module-meta) # 由每个模板推导出目标头文件列表 # 例如 core.meta.slang - core.meta.slang.h foreach(meta_source ${core_module_meta_source}) file(RELATIVE_PATH meta_source_relative ${core_module_meta_source_dir} ${meta_source}) list(APPEND core_module_meta_generated_headers ${core_module_meta_output_dir}/${meta_source_relative}.h) endforeach() add_custom_command( OUTPUT ${core_module_meta_generated_headers} COMMAND ${CMAKE_COMMAND} -E make_directory ${core_module_meta_output_dir} COMMAND slang-generate ${core_module_meta_source} --target-directory ${core_module_meta_output_dir} DEPENDS ${core_module_meta_source} slang-generate WORKING_DIRECTORY ${core_module_meta_source_dir} VERBATIM )由此可以得到几个关键的工程事实输入是source/slang/下全部*.meta.slang文件输出目录为构建目录下的core-module-meta/输出命名规则每个输入文件name.meta.slang对应生成name.meta.slang.h生成逻辑见下文命令行一节生成的头文件随后被编译进slang-embedded-core-module-source等目标成为编译器二进制的一部分同一 CMakeLists 的 78–84 行将该目标EXPLICIT_SOURCE指定为这些生成头。这些生成产物会被编译器核心源码直接引用例如 source/slang/slang-capability.cpp 的#include slang-generated-capability-defs-impl.h、source/slang/slang-capability.h 与 source/slang/slang-compiler-options.h 的 include都是从源文件声明 → 工具生成 → 编译器使用链条下游的真实消费者。命令行接口与参数解析main.cpp中usage()函数给出了工具的命令行形态main.cppusage: slang-generate [FILE]... [--target-directory FILE]即一个或多个输入文件外加一个可选的--target-directory输出目录。参数解析逻辑位于main()开头main.cpp依次扫描argv遇到--target-directory时读取其下一个参数作为输出目录并通过Path::simplify归一化路径其余参数一律视为输入文件路径同样经过Path::simplify——源码注释特别说明这一简化会把路径分隔符统一为/从而保证后续在生成的代码里输出路径时结果正确如果没有任何输入文件直接打印 usage 并退出返回码 1。输出文件的最终路径按两种情形决定main.cppif (outputDir.getLength()) outputPathFinal outputDir / Slang::Path::getFileName(inputPath) .h; else outputPathFinal inputPath .h;指定了--target-directory时输出目录/输入文件名.h未指定时直接在输入文件同名基础上追加.h即core.meta.slang.h紧挨着core.meta.slang生成。输入文件的分类与解析策略slang-generate并不会对所有输入一视同仁而是按扩展名选择处理方式。parseSourceFile中维护了一张分派表main.cpp扩展名处理方式说明.meta.slangparseTemplateFile按模板语法完整解析生成代码.meta.cppparseTemplateFile同样作为模板解析.cppparseCxxFile目前只预留了从源文件抓取元数据的 TODO实际返回nullptr不处理其他parseUnknownFile不处理解析器把整个文件读入内存后交由readBodyfalse以文档级视角扫描openChar/closeChar取-2意味着顶层扫描不受括号配对约束只是逐字符识别模板指令main.cpp。模板语法text / splice / escape 三种节点整个模板模型建立在一种简单的**节点链表Node 链**之上。Node结构main.cpp只有三种Flavortext需要原样写入输出的普通文本escape元级代码语句其body是子节点链表splice元级表达式结果将被拼接到输出中。模板文件就是文本 少量$指令的混合体。解析器readBodymain.cpp遇到$时根据紧随其后的字符分派到不同的语法形式。1. 表达式插入$(表达式)当$后紧跟(时表示一个表达式 splicemain.cpp$(expr)解析器先终结前一段文本节点然后调用readBodytrue(reader, 0, (, 0, ))递归读取括号体并创建splice节点之后继续收集后续文本。这里的模板参数onlyReadFirstOpenChar true有一个非常实际的用途——源码注释明确说明main.cpp它允许myFunc($((int)val))这种写法被正确解析。如果一次性吞掉所有连续的(括号体会被错误截成int)val导致后续出现难以察觉的段错误。2. 块级转义${...}...$}当$后紧跟{时进入块结构转义block-structured escape以$}收尾main.cpp${ 这里是元级代码 }其中内容被收集为escape节点的 body。注意该块与 C 风格花括号无关终止条件只看$}组合。3. 行级语句转义行首$:当$出现在行首且后跟:时这是一条语句转义statement escape持续到本行行尾main.cpp$: 一条元级语句实现上$前从lineBegin起的文本被终结为 text 节点冒号后的内容包括行尾换行整体作为escape节点。也就是说这种形式让开发者可以在模板里按行嵌入控制逻辑。4. 语句插入行首$identifier当$出现在行首且后跟标识符字符时属于语句插入statement splicemain.cpp。它支持类似下面的写法$T0::SomeTypeDefine源码注释解释了为何需要这个语法main.cpp在 C/CUDA 目标下(SomeTemplate...::SomeTypeDefine)这种给类型表达式加括号的写法是不合法的因此模板生成器需要一种不依赖括号的语句插入形式。解析时它会消费一个可选标识符、可选水平空白、可选的()包裹块只保留最外层以及{前的可选空白/换行。5. 普通$的处理如果$后跟的字符不属于以上任何情况则视为输出中的字面$main.cpp不会当作指令。其他细节空白与换行解析器区分水平空白空格、制表符与换行\r\n组合通过handleNewline折叠处理main.cpp保证 Windows/Linux 行尾在模板与输出中行为一致括号配对对$(...)这类单字符开闭的体内部遇到(/)会维护depth计数只有深度回到 0 时才认为体结束main.cpp因此$(内部允许嵌套圆括号。输出机制生成什么形式的 C 代码解析得到的节点链表通过emitTemplateNodes产出最终代码main.cpp。三种节点的发射策略各不相同text 节点发射为SLANG_RAW(...)宏调用其中的换行、制表符、引号、反斜杠等一律转义为字符串字面量形式转义细节见emitStringLiteralTextmain.cppsplice 节点发射为SLANG_SPLICE(...)宏调用参数为节点的原始代码escape 节点直接展开其 body 的代码emitCodeNodesmain.cpp。也就是说模板文件最终被翻译成一系列SLANG_RAW(...)/SLANG_SPLICE(...)宏调用的 C 序列这些宏由生成头文件的上游消费方按需定义展开。emitRawmain.cpp还展示了另一种文本发射路径逐字符把文本转换为sb ...形式的流式拼接语句并把换行拆成\n;换行后继续sb 的连续语句。一个值得注意的设计是#line指令的自动插入main.cppemitTemplateNodes预先用StringUtil::calcLines建立源文件的行断点索引当节点序列从escape过渡回text时用二分查找_findLineIndexmain.cpp定位该文本在模板源文件中的行号并发射SLANG_RAW(#line N \文件名\)这样即便代码是由模板展开生成的编译器在报告错误、打印诊断时也能把行号映射回原始的.meta.slang模板文件路径使用Path::getFileName得到的纯文件名见 main.cpp大幅提升可调试性。增量输出只在内容变化时落盘写文件环节同样经过精心设计main.cpp先把展开结果写入临时文件输入路径.temp.h计算最终输出路径带或不带--target-directory读取最终目标文件的旧内容与新临时文件内容进行比较仅当新旧内容不一致时才覆盖写入最终文件writeAllText失败时报G0001错误无论是否写入最后都删除临时文件。这一先写临时文件、再比对、后替换的策略带来了两个实际收益构建期内重复执行生成命令不会无谓地触碰文件时间戳避免下游不必要的重编译且只有真正发生内容变化时才触发依赖重编译。实战视角模板文件长什么样理解了语法与机制后再看真实模板会更容易建立直觉。以核心模块 core.meta.slang 为例它以一个public module core;声明开头随后用 Slang 语言本身声明编译器需要的内建实体例如基础类型别名typedef half float16_t; typedef float float32_t; typedef double float64_t; typedef int int32_t; typedef uint uint32_t; typedef uintptr_t size_t; typedef uintptr_t usize_t;以及语法修饰符的声明syntax modifier例如syntax constexpr : ConstExprModifier; syntax globallycoherent : GloballyCoherentModifier;这些声明被slang-generate展开为 C 头文件后编译器的前端AST 构造、语义检查等便可以在 C 侧引用这些内建实体——例如 source/slang/slang-ast-builder.cpp 提到core.meta.slang、hlsl.meta.slang等模板文件最终都归入同一个Core模块source/slang/slang-check-conversion.cpp 也直接引用了core.meta.slang中声明的__EnumType等内建类型。这意味着标准库的源码就是模板编译器自身的 C 表示由模板驱动生成避免了手写两份定义带来的漂移风险。同样地能力capability体系的维护也遵循只改源文件、不碰生成文件的约定slang-capabilities.capdef注释明确要求新增能力时编辑该文件而非生成的头文件source/slang/slang-capabilities.capdef。小结一套可复用的构建期元编程管线slang-generate虽小单文件实现约 966 行 C但它完整承载了 Slang 编译器以元模板为真源的代码生成哲学模板语法极简但够用textescapesplice三种节点配合$(...)、${...}、行首$:、行首$identifier四类指令即可在普通文本中嵌入任意元级逻辑输出即 C模板被翻译为SLANG_RAW/SLANG_SPLICE宏序列并在 escape→text 边界自动插入#line指令保证生成代码的可诊断性工程友好支持--target-directory、路径归一化、\r\n兼容、临时文件比对后的增量写入与 CMake 的add_custom_command无缝配合闭环消费core.meta.slang等模板生成的头文件被编译进slang-embedded-core-module-source进而由slang-capability.cpp、slang-compiler-options.h等编译器核心源码直接 include完成从Slang 语言声明到编译器 C 内建的自动化闭环。如果你正在阅读 Slang 编译器源码source/slang/*.meta.slang与其构建产物是最值得对照阅读的一对输入输出如果你想在自研编译器中落地类似方案slang-generate的节点链表模型、#line映射与增量写入策略都是可以直接借鉴的成熟设计。【免费下载链接】slangMaking it easier to work with shaders项目地址: https://gitcode.com/GitHub_Trending/sl/slang创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考