GLSL中#line指令工作原理及与着色器编译日志的关联

核心工作机制 #

GLSL预处理器规则基本对齐标准C预处理器，#line是从C标准继承的指令，GLSL额外扩展了源单元编号的可选参数，语法如下：

#line <行号> [源单元编号]

它的本质是直接修改预处理器内部维护的两个位置计数器：

• 这行#line指令本身执行完成后，紧跟着的下一行代码的行号会被强制设置为传入的行号值，后续逐行累加计数
• 如果传入了源单元编号参数，后续所有代码所属的源ID会被更新为该值
• 之后编译器生成警告、错误信息时，会直接使用这两个计数器的值标记代码位置，完全覆盖默认的全局行号计数规则。

与数组装载源码、编译日志的关联 #

这个指令和多段数组传参的写法、glGetShaderInfoLog输出的编译日志是强关联的，核心作用是解决多段字符串拼接带来的错误位置错位问题：

• 调用glShaderSource传入字符串数组时，驱动不会区分各字符串的边界，会直接按数组顺序把所有字符串拼接成一整段连续源码再交给编译器处理。如果没有#line指令，编译器默认会把拼接后整段源码的第一行（即示例中ver字符串里的#version 120）记为源单元0、行号1，后续逐行累加。
• 示例中顶点、片段着色器共用同一个body源码段，当前编译时前面拼接的版本声明、着色器类型宏定义占2行，但后续如果要新增公共宏、扩展声明等前缀内容，前缀占的行数会发生变化。此时如果body内的代码出错，glGetShaderInfoLog返回的错误行号是全局拼接后的行号，每次定位错误都要手动减去前缀行数，调试效率很低。
• 在body开头加上#line指令后，不管前面的前缀占多少行，body内部的行号、源单元编号都会被重置为指定值。示例中将源单元编号设为1、行号设为0（常规开发习惯会设为1，和日常行号从1计数的认知对齐），后续查看编译日志时，只要是源单元1抛出的错误，直接用日志里的行号就能定位到body字符串里的对应位置，不需要手动计算前缀偏移。
• 补充说明：示例中写#line 0 1会导致body的第一行（#ifdef VERTEX_SHADER）被标记为第0行，不符合常规的行号计数习惯，改成#line 1 1会更适配调试直觉。

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