Godot 2D Outline着色器边缘像素重复（渗色）问题求解

问题成因 #

这款外描边着色器的核心逻辑是通过采样当前像素周边的纹理坐标，判断相邻区域是否存在不透明像素，以此生成向外延伸的描边。当你的PNG图像边缘完全贴合纹理的0-1 UV边界时，着色器采样边界外区域会触发Godot纹理的默认Wrap规则：

• 若设为Repeat模式，会重复采样图像边缘像素；
• 若设为Clamp to Edge模式，会持续取图像最边缘的像素值；
  两种情况都会让着色器误判边界外区域为“有有效像素”，最终生成重复的边缘像素，而非正常的透明基底外描边。而添加1像素透明边框后，纹理边界内的透明区域让着色器采样到正确的透明值，自然能生成正常描边。

无需修改资源的解决办法 #

1. 修正Shader采样逻辑（最彻底） #

修改outline2D_outer.shader中的纹理采样代码，强制让UV超出[0,1]范围的采样返回透明值，无需调整纹理资源：
找到着色器中处理纹理采样的代码段，替换为以下逻辑：

// 采样纹理，并对超出UV范围的区域强制设为透明
vec4 tex_color = texture(TEXTURE, UV);
float in_bounds = step(0.0, UV.x) * step(UV.x, 1.0) * step(0.0, UV.y) * step(UV.y, 1.0);
tex_color *= in_bounds;
COLOR = tex_color;

这段代码通过step函数判断UV是否在合法范围内，超出则将采样颜色置为透明，从根源上解决边界采样错误的问题。

2. 微调Sprite的Region UV范围 #

在Sprite节点的Inspector面板中，展开Region属性，将Rect的默认值(0, 0, 1, 1)微调为(0.001, 0.001, 0.999, 0.999)。这个微小的收缩会让原图像边缘与纹理边界之间留出极窄的“虚拟透明边框”，着色器采样边界外区域时会取到透明值，从而正常生成描边。

3. 缩小描边采样偏移量 #

调整着色器中描边采样的偏移距离，避免采样点越界：
找到原Shader中定义采样偏移的代码（通常是基于OUTLINE_WIDTH和TEXTURE_PIXEL_SIZE计算的offset变量），给偏移量乘以一个小于1的系数，比如：

// 原代码示例：
vec2 offset = vec2(OUTLINE_WIDTH / TEXTURE_PIXEL_SIZE.x, 0.0);
// 修改为：
vec2 offset = vec2(OUTLINE_WIDTH / TEXTURE_PIXEL_SIZE.x * 0.9, 0.0);

这个方法会略微缩小描边宽度，需要根据实际效果微调系数，适合不想修改采样逻辑的快速解决场景。

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