Unity SpriteMask完全指南：使用条件、原理与常见坑

做2D项目的时候，很多人都会碰到类似需求：让角色只显示在某个圆形区域里、让地图只露出一小圈视野、或者做一个从中心向外扩散的加载光圈。我最早遇到SpriteMask，是在做2D割草小游戏时要给地面奖励物品加“可见范围”限制，一开始直接挂了UGUI的Mask（就是Canvas下那个），结果发现它对Tilemap、SpriteRenderer完全没作用，折腾了一晚上才搞明白要用SpriteMask。

这篇就专门把SpriteMask的使用条件完整梳理一遍。你以为的SpriteMask可能是“拖个组件上去就能用”，实际坑其实不少：精灵导入模式、Mask Interaction设置、Sorting Layer范围、URP下的Shader兼容、移动端合批影响，少了任何一个条件，表现就可能完全不对。我会从原理、实操到问题排查串一遍，尽量让新手照着能做出来，也让老手能翻到一些平时容易忽略的点。

1. 先搞清楚SpriteMask到底是什么，能解决什么问题

1.1 SpriteMask的定位和核心原理

SpriteMask是2D渲染体系里的遮罩组件，挂在场景中某个物体上，指定一张精灵图作为“遮罩形状”，然后影响所有SpriteRenderer渲染的精灵。它本质上走的是模板缓冲（Stencil Buffer）机制：先往Stencil里写入遮罩形状，再拿这个模板值去过滤后续的精灵像素，只在模板值匹配的区域让像素通过。

用生活化的方式理解就是：你现在有一张照片（目标精灵），还有一张镂空纸板（SpriteMask的遮罩形状），把纸板盖在照片上，只有镂空的地方能看到照片，其他地方都被挡住。Unity里这个“镂空纸板”可以是一张带Alpha通道的贴图，可以是一个圆、一个五角星、一条狭长光带，甚至是一张手绘的不规则形状。

这也是为什么SpriteMask和UGUI的Mask不通用：UGUI的Mask主要作用在Canvas下的UI元素上，处理的是UI mesh；SpriteMask作用在2D渲染管线上，两者底层处理的渲染对象完全不同。所以“我要裁剪Tilemap”或者“我要裁剪一张带动作的角色Sprite”时，UGUI Mask指望不上，得用SpriteMask。

1.2 它最常见的应用场景有哪些

我实际用下来，SpriteMask在下面几类需求里表现很稳：

• 头像裁切：角色头像从方形贴图裁成圆形，动态更新贴图也不会出问题。
• 视野/战争迷雾：整个地图先铺一层黑色，再用SpriteMask镂空出玩家周围一圈视野。
• 加载进度光圈：用一张圆环或扇形SpriteMask，代码缩放或旋转遮罩，再配合材质变化做成进度环。
• 机关区域限制：比如只允许在某个法阵范围内显示特效，区域外一律擦除。
• 碎片拼图：用多块自定义形状的遮罩，配合SpriteRenderer做组合显示。

这些场景有一个共同点：遮罩边缘要求其实并不高，不需要像素级柔边，但需要实时变化、动态位移、缩放或旋转。SpriteMask因为只是模板缓冲机制，没走CPU裁剪，性能上比动态改Mesh要舒服很多。

1.3 和Mask、RectMask2D的对比选型

这里给个简单对比，方便第一眼判断该用哪个：

如果你是给UI头像做圆形裁剪，优先考虑UGUI的Mask或者直接用Image的圆形Sprite；如果你是给3D世界里的Billboard或者2D场景里的角色做遮罩，那才是SpriteMask的舞台。选错组件的后果就是你发现怎么设置都不生效，因为两者根本不在一套渲染流程里。

2. 使用SpriteMask前必须满足的条件，少一个都不行

2.1 精灵资源本身的硬性条件：Sprite Mode必须是Single

这是新手最容易踩的第一个坑。你要用来作为遮罩形状的贴图，在导入设置里必须把Sprite Mode设为Single（单张），不能是Multiple（多张图集模式）。

原因其实不难理解：SpriteMask在内部读取贴图时，需要直接关联一张可用的Texture和对应的Sprite Rect。如果贴图是Multiple模式，Unity不知道你要用哪一格作为遮罩形状，虽然Inspector面板上你强行把这一格拖到SpriteMask的Sprite字段里也有可能拖进去，但运行时经常出现遮罩失效、形状错乱、或者编辑器直接提示Sprite Mode不匹配。实际项目中，美术给的遮罩贴图经常和角色动画图集放一起，导入默认可能是Multiple，我就吃过这个亏。解决办法是遮罩相关的贴图单独放一个目录、单独设置Single模式。

另外，遮罩贴图的Alpha通道很重要。SpriteMask判断“哪些地方是遮罩”“哪些地方不是遮罩”，靠的就是贴图的Alpha值。如果你的贴图没有Alpha通道，或者整张图完全不透明，那么遮罩就退化成一个全屏矩形，裁剪效果肯定不对。建议遮罩贴图做成“白底透明背景，内部白色实心形状”这种最常见形态，白色实心区域=可见区域，透明区域=被隐藏区域。

2.2 目标精灵必须设置Mask Interaction，否则遮罩不生效

很多人拖完SpriteMask，发现场景里的Sprite安安稳稳显示，一点变化都没有。十有八九是忘了改SpriteRenderer上的Mask Interaction属性。

每个SpriteRenderer组件上都有一个Mask Interaction下拉框，默认是None。只有把它改成下面两个选项之一，这个SpriteRenderer才会受到SpriteMask影响：

• Visible Inside Mask：只在遮罩形状内部显示，外部透明。
• Visible Outside Mask：只在遮罩形状外部显示，内部透明。

我印象里最常犯的错误是：创建了一个SpriteMask就以为完事，结果目标精灵的Mask Interaction还留在None。这里建议养成习惯，创建遮罩后先确认两个点：一是SpriteMask组件的Sprite字段有没有正确拖入遮罩贴图，二是目标SpriteRenderer的Mask Interaction是不是自己想要的模式，缺一个，效果都出不来。

这个属性的“影响范围”是叠加的：场景中如果有多个SpriteMask，一个SpriteRenderer受到的影响是所有遮罩叠加后的结果。如果你做双遮罩（比如一个圆环限制外圈，一个矩形限制范围），可以给同一个SpriteRenderer设Visible Inside Mask，它会同时与多个SpriteMask做模板比较，这也是做复杂裁剪的常用手段。

2.3 层级关系决定裁剪范围：Sorting Layer和Order in Layer

第三个使用条件，是层级关系。SpriteMask在渲染时只影响特定的Sorting Layer范围，默认情况下它影响所有Sorting Layer和Order in Layer，但你要是开启了Custom Range模式，就必须指定Front Sorting Order和Back Sorting Order，超过范围的SpriteRenderer就不会被裁剪。

不开启Custom Range时，所有SpriteRenderer都会被这个SpriteMask影响，不管你的Sorting Layer是Background还是Foreground。听起来挺省事，但也容易出问题：场景里如果有UI元素的SpriteRenderer、特效的SpriteRenderer，你可能只打算裁剪一只怪物，结果整层都跟着被裁剪了。所以我建议，项目稍微复杂一点，就养成用Custom Range的习惯。

比如你要做的效果是“只在某个法阵范围内显示粒子特效”，粒子系统的Renderer如果是SpriteRenderer类型，且Sorting Layer为默认层、Order in Layer为5，那么SpriteMask的Custom Range里把Back Sorting Order设为0、Front Sorting Order设为10，粒子就不会跑出遮罩效果范围。

这里有一个容易误解的地方：SpriteMask自身也有Sorting Order，但它不影响“遮罩形状本身的显示”——SpriteMask组件在场景中不渲染任何像素，它只写模板值。真正决定裁剪层级的是它的Custom Range和目标SpriteRenderer的Sorting Layer/Order，这一点刚开始用会有点绕。

2.4 坐标、缩放和Pivot：遮罩形状的显示区域由Transform决定

这个看似简单，实际项目里问题也不少。SpriteMask遮罩在屏幕上的位置、大小、旋转，完全取决于SpriteMask所在GameObject的Transform。它没有独立的“遮罩尺寸”参数，你缩放GameObject，遮罩形状跟着放大缩小；你旋转GameObject，遮罩形状跟着旋转。

这里有两个细节注意一下：

一是Pivot（轴心）问题。遮罩贴图的Sprite设置里Pivot默认是Center，也就是说SpriteMask的Transform位置对应贴图的中心点。如果你做的是圆形扩散效果，用代码把localScale从0放大到N，扩散的中心就是Pivot中心，通常没问题。但如果你用的是不规则贴图，Pivot设置在Bottom或Top，旋转和缩放结果会和你预想的不太一样。

二是非等比缩放。SpriteMask对非Uniform缩放（比如x方向拉长、y方向不变）一般也能正确裁剪，但在移动端某些GPU驱动上，非等比缩放的模板边缘会出现锯齿或偏移。我建议能用等比缩放就用等比缩放，如果必须拉长，考虑重新出一张扁形遮罩贴图，不要在Transform上硬拉。

2.5 渲染管线和Shader兼容：内置管线和URP要区别对待

这个条件最隐蔽，尤其在你项目从内置渲染管线切到URP之后。SpriteMask的正常工作依赖Shader里正确处理Stencil模板缓冲。默认情况下，SpriteRenderer用的材质是内置的Sprite/Default，这个Shader天然支持模板缓冲，所以你在内置管线项目里拖个SpriteMask，设置好Mask Interaction，效果直接就有了。

但是切到URP之后，情况会变。URP项目里SpriteRenderer如果用默认材质，Unity一般会自动使用URP对应的Sprite默认Shader，通常也能支持模板缓冲。但如果你给SpriteRenderer挂了自己写的Shader，或者用了某些第三方UI/特效Shader，这些Shader可能压根没有处理Stencil逻辑，那么遮罩就全部失效。

如果你的URP项目里发现SpriteMask对该精灵无效，优先检查材质用的Shader是不是以下两类：URP/2D/Sprite-Default，或者自定义Shader里有没有Stencil相关操作（比如Comp、Pass、ReadMask、WriteMask这些关键字）。对自定义Shader，比较省事的做法是不动Shader，直接把SpriteRenderer的材质换成URP/2D/Sprite-Default，让默认Shader去处理遮罩交互。

还有一个URP特有坑：URP里如果开了2D Renderer的某些功能（比如法线贴图、二次纹理合成），底层渲染会多走几个Pass，这时候SpriteMask和Material之间的匹配会变得更加敏感。遇到遮罩不生效，先关掉2D Renderer里的额外贴图功能做排查。

2.6 非Sprite对象：色块、模型、UI不能直接用SpriteMask

最后一条条件，本质上是个边界认知：SpriteMask只作用于SpriteRenderer和部分基于SpriteRenderer的功能，对3D MeshRenderer、ParticleSystem里的Mesh粒子、UI Image这些对象，它不直接生效。

我见过有人想在SpriteMask下裁剪一个3D圆柱体，结果绕了很久。真要做3D裁剪，需要用Shader的Stencil或者专门的矩形裁剪方案；要做UI裁剪，回Canvas体系用Mask；要做粒子裁剪，粒子系统的Renderer Module里渲染模式选择SpriteRenderer类型才可能受SpriteMask影响。

所以在项目规划阶段，就要先确认：被裁剪的物体是不是2D精灵体系，如果不是，这个方案得换。

3. 手把手搭一个可复用的遮罩案例

3.1 准备资源和创建基础场景

我车上用的案例是“角色圆形头像 + 扩散光圈”的组合效果，既能演示SpriteMask的基本用法，也能演示代码控制。

第一步准备资源。你需要两张图：

• 一张角色精灵图，比如一张宽度128、高度128的卡通头像贴图，导入设置里Sprite Mode设为Single，Pivot默认Center。
• 一张圆形遮罩贴图，白色实心圆、周围透明，建议尺寸256x256，边缘可以留一点点半透明过渡带，这样边缘不会太生硬。导入设置同样是Sprite Mode设为Single。

场景里建好三样东西：

1. 背景物体（一个SpriteRenderer，随便放一张底图，用于对比遮罩前后效果）。
2. 角色物体（挂SpriteRenderer，拖入角色精灵图，Sorting Layer设为Default，Order in Layer设为1）。
3. SpriteMask物体（新建空物体，挂SpriteMask组件，把圆形遮罩贴图拖进Sprite字段）。

只做这三步，运行起来你会发现背景、角色都正常显示，但角色没有产生任何裁剪效果。原因就是我们前面说的：角色SpriteRenderer的Mask Interaction还是None。

3.2 打开遮罩交互，并区分内外模式

选中角色物体，在SpriteRenderer组件上找到Mask Interaction，从None改成Visible Inside Mask。这时候运行，角色就只在圆形遮罩范围内显示了，圆外部分完全看不到。你拖拽SpriteMask物体到不同位置，圆形可见区域会跟着移动，非常直观。

如果你想做的是“遮罩内隐藏、遮罩外显示”，把Mask Interaction改成Visible Outside Mask即可。这个逻辑在游戏里常用来做“未被探索区域变暗”——先铺一层黑色半透明Sprite，遮罩外显示黑色、遮罩内隐藏黑色，就变成“玩家周围一圈亮、远处变暗”的效果。

我在实际项目里遇到过一种情况：图省事把角色的Mask Interaction设成Visible Inside Mask，但忘了改场景里其他同层精灵。结果一个屏幕可能同时挂了几十个小怪，个个都被同一个圆形遮罩切了一道，看起来像集体穿越到另一个次元。所以层级管理一定要做，不要把所有精灵都留在Default层。

3.3 用代码控制SpriteMask的缩放与动态效果

下面给出动态扩散光圈的简单C#脚本，可以直接挂到SpriteMask物体上。这里用Time.unscaledDeltaTime是故意的，因为这类“受击反馈光圈”通常希望不受游戏暂停影响。

csharp复制using UnityEngine;

public class ExpandingMask : MonoBehaviour
{
    public float duration = 1.5f;
    public float maxScale = 5f;
    private SpriteMask mask;
    private float timer;

    void Awake()
    {
        mask = GetComponent<SpriteMask>();
    }

    void OnEnable()
    {
        timer = 0f;
        transform.localScale = Vector3.zero;
    }

    void Update()
    {
        timer += Time.unscaledDeltaTime;
        float t = Mathf.Clamp01(timer / duration);
        float scale = Mathf.Lerp(0.1f, maxScale, t);
        transform.localScale = new Vector3(scale, scale, 1f);

        if (t >= 1f)
            gameObject.SetActive(false);
    }
}

这个脚本的关键是：每帧更新Transform.localScale，让SpriteMask从很小放大到很大，角色只在当前遮罩范围内可见，视觉上就是一个“光圈扩散后角色消失”的效果。

如果你要做的不是等比扩散，而是进度条式扇形加载，可以换一种思路：不要改scale，而是准备一张扇形精灵（比如四分之一圆），旋转SpriteMask或者更换Sprite字段中的扇形贴图，再配和进度数值。实操时要注意扇形遮罩的旋转中心和Pivot需要精确对齐，否则进度条看起来会歪。

3.4 配合图集（Sprite Atlas）时的注意事项

现实中资源一般不会单独一张一张放，我项目里会打图集。这里的坑是：你把圆形遮罩贴图也放进了同一个Sprite Atlas，然后这个Atlas打包模式是Multiple或者图集里存在多精灵Rect，SpriteMask还会不会生效？

我的经验是：只要SpriteMask实际拖入的Sprite资源是Single模式的独立Sprite，那么即使它被打包进图集，也能正常工作，因为Unity会把Sprite的UV信息映射到图集对应区域。真正的问题出在编辑器面板上，有时你拖拽图集里的小图到Sprite字段，Inspector显示正常，但运行时模板缓冲区域计算错误，表现为遮罩偏移或者错位严重。

我自己的做法是：遮罩资源不进大图集，单独放在一个Resources或专门目录下，甚至单独打一个小图集，尽量避免和角色的动画帧混在同一张Atlas里。这样做监测成本低，后续如果要动态换遮罩形状，也不会因为图集更新而导致引用失效。

4. 常见问题排查与避坑心得

4.1 常见问题速查表

下面这个表是平时群里问得最多的几类现象，基本能覆盖80%的排查场景：

4.2 渲染顺序、合批与性能：为什么你的帧率会掉

值得一提的是，SpriteMask虽然实现简单，但它是会打断合批的。原因也很直接，模板缓冲需要额外的渲染Pass写入，GPU不能在同一个Draw Call里既写模板又读模板。如果你场景里同时存在几十个SpriteMask，每个遮罩范围内又有大量精灵，性能会很快恶化。

项目里我踩过的具体案例是：一张地图上摆了30多个圆形遮罩，每个遮罩下面是一个动态小怪，结果在低端安卓机上最低帧掉到20帧。后来排查发现DrawCall翻了三倍，根源就是SpriteMask把原本能合批的精灵强制拆分了。

解决方向主要有三个：

1. 减少SpriteMask数量，能用一张大遮罩覆盖多个区域就尽量合并。
2. 用SpriteMask时尽量让目标Sprite之间的材质、图集、Sorting参数一致，降低合批难度。
3. 如果只是UI头像裁剪，别用SpriteMask，回到UGUI的Mask体系，避免在2D场景渲染流程里做模板操作。

还有一个容易被忽视的细节：SpriteMask的Alpha Cutoff参数。这个值默认是0.1，含义是遮罩贴图像素Alpha低于这个值时，该像素不写入模板缓冲。你如果做柔边遮罩，把Alpha Cutoff调低，可以让过渡更圆润；但调太低也会让极淡的半透明区域变成可见区，视觉上出现“虚影”。我一般会以遮罩贴图的Alpha过渡带宽度来定，大概0.05到0.3之间来回调试。

4.3 和TextMeshPro、UI混排时容易踩的坑

很多人做2D游戏时，场景里会同时有SpriteMask、TextMeshPro文字和UGUI界面。热词里有个“textmeshpro 会被ui挡到”的问题，它和SpriteMask也经常搅在一起。

我的建议是这样：SpriteMask根本管不到TMP，因为TMP默认是UGUI体系（在Canvas下渲染），SpriteMask只影响SpriteRenderer。如果你的TMP被UI挡到，那是Canvas的Sorting Order和Render Mode问题，不是SpriteMask的锅，别混为一谈。

但如果TMP里的某个文字需要做“圆形裁剪露出一半”的效果，就不要直接想着SpriteMask了。正确做法是在UI体系里用Shader加模板，或者更实际一点：把文字渲染成RenderTexture，再用Image按钮的圆形遮罩区域来裁剪。SpriteMask跨界管UI，永远是得不偿失的。

另外，如果你的场景用了URP，并且UI层和2D场景是分开两个Camera渲染的，要特别注意Camera的Clear Flags和Depth设置。SpriteMask是跟着2D场景相机的渲染流程走的，如果UI相机在后处理阶段又清了Stencil，那么UI之上的覆盖物会重新洗掉模板值，导致2D场景里的遮罩在你切到UI界面时表现异常。这个情况比较少见，但一旦遇到，优先排查相机顺序，而不是在SpriteMask上反复调参数。嗯，是这样的。

4.4 小游戏与WebGL环境下的额外注意事项

微信小游戏和WebGL是很多人问的另一大块。我记得热词里有一堆关于微信小游戏打包、WebGL帧率稳定的内容，说明这两个平台的兼容性确实折磨人。SpriteMask在WebGL上能不能用？我的答案是：能用，但有几个额外条件。

第一，要确认渲染API。WebGL 1和WebGL 2对Stencil的支持其实都算完整，但部分安卓WebView或者小游戏运行环境，Stencil缓冲区可能被引擎其他Pass占用，或者帧缓冲配置里没有开Depth+Stencil，这时候SpriteMask直接失效。排查方法是打开Frame Debugger看渲染事件里有没有模板相关Pass，如果完全没有，就是底层环境配置问题。

第二，微信小游戏环境不建议放太多SpriteMask。小游戏的合批和Shader变体管理比原生端要严格，SpriteMask增多不仅带来DrawCall上升，还会带来Shader变体数量上升，首包尺寸和加载时间都可能受影响。如果只是做头像裁剪、视野提示，尽量用透明贴图+静态UI方案代替动态SpriteMask。

第三，如果非要在移动端用SpriteMask，建议打开SpriteRenderer上的Mask Interaction后，把被裁剪精灵的Material尽量统一。我在小游戏项目里实测，统一材质后DrawCall上升明显受控，帧率也能稳住60帧。

5. 一些实践心得和可以继续扩展的方向

最后聊点实战中的心得体会。做遮罩效果，最重要的是分清楚自己要的到底是“裁剪结果”还是“视觉遮罩”：“裁剪结果”是资源层面、渲染层面的像素级处理，用SpriteMask； “视觉遮罩”是看起来被盖住了，实际上物体还在完整渲染，用半透明Sprite遮挡就够了。很多人一开始分不清，结果为了做一个“区域外变暗”的效果，硬是给整个地图加了一层SpriteMask，白白增加性能负担。

另外，多利用SpriteMask的Custom Range可以解决很多“误伤”问题。比如角色脚下有一个高亮的圆形光圈，你希望光圈只裁剪角色身体的一部分，但不希望它把地面贴图也裁一遍，那就在Custom Range里指定只影响某一个Order范围。这个思路在制作复杂BOSS战、场景机关、角色高亮反馈时非常实用。

说到扩展，SpriteMask加上Shader可以玩出很多花样：模板缓冲不只是二值裁剪，你可以在自定义Shader里结合Stencil值做出多级半透明效果；SpriteMask搭配粒子系统模拟“溶解”“扩散”也比预想中顺手；做成武器挥砍的残影范围、地图传送门的光效，都是现有方案稍加改动就能实现的。

拿一个具体例子来说：我做“扇形扫描雷达”的时候，就是把一张扇形遮罩图片逐渐旋转，目标精灵的Mask Interaction设为Visible Inside Mask，只用一个SpriteMask，就实现了类似雷达扫描发现目标的反馈，效果比单独做Shader贴图裁剪要简单得多，逻辑也更直观。

如果你以前觉得SpriteMask只是“圆形头像专用”或者“只在特定版本里能用”，我建议找个空闲时间，照着上面的条件把场景搭一遍，把Single模式、Mask Interaction、Custom Range、URP Shader这几个点逐一试过来。整个过程熟练之后，你会发现2D游戏里的很多视觉限制，本质上都是渲染条件匹配的问题，而SpriteMask的使用条件，也许是一个帮你理解Unity渲染机制的很好的入口。