1. Unity UI 鼠标移入移出切换光标样式与尺寸的完整实现在 Unity 里做 UI 交互按钮点得动只是及格线真正让玩家觉得「这游戏手感不错」的往往是鼠标移上去那一瞬间的反馈。我最近在做一个带大量图标按钮的面板产品提了个很具体的要求鼠标悬停在按钮上时光标要换成一只小手而且要比默认光标大一圈移开之后立刻还原。听起来简单但真动手做你会发现 Unity 的Cursor.SetCursor有一堆细节坑比如光标贴图必须是 Cursor 类型、尺寸被限制在 32×32、热点坐标算错会导致点击位置偏移。这篇就围绕「Unity UI 鼠标移入移出改变光标样式和大小」这个场景把可复制的脚本、光标资源导入配置、Play 模式验证步骤全部走一遍。同时我会把调试期用到的多模型调用通道也串进来——因为写这类交互脚本时我习惯让 AI 帮我补边界情况、查 API 签名而多个模型来回切很容易把 Key 管乱用 TaoToken 统一 Key 之后调试期的模型调用就清爽很多。适合正在做 Unity UI 交互、被光标切换卡住、或者想顺手把 AI 辅助调试流程理顺的开发者。核心检索词先摆出来Unity UI 鼠标移入移出改变光标样式和大小本质是通过IPointerEnterHandler/IPointerExitHandler两个接口在事件触发时调用Cursor.SetCursor切换光标贴图与热点。它能让你的按钮、道具格、技能图标在悬停时有明确的视觉反馈适合所有做 2D/3D UI 的 Unity 开发者。先说清楚一个前提Unity 的硬件光标Cursor.SetCursor和软件光标自己画一个 Image 跟着鼠标跑是两条路。前者性能好、系统级生效但受限于贴图格式和 32×32 尺寸后者自由度高但要多写一套跟随逻辑。这篇讲的是硬件光标方案因为「改变大小」这个需求在硬件光标下其实是通过准备两张不同尺寸的贴图来实现的——Unity 不允许你动态缩放光标只能换图。这一点很多人第一次做会踩坑以为SetCursor能传个 scale 参数其实没有。所以整体思路是准备两张 Cursor 类型贴图普通小手 32×32、放大版小手 32×32 但图形本身画得更大移入时换成放大版移出时换回默认或普通版。下面按步骤来。2. TaoToken 统一 Key 管理调试期多模型调用写 Unity 交互脚本的过程中我经常需要 AI 帮忙做几件事查Cursor.SetCursor的参数顺序、确认IPointerEnterHandler的命名空间、让模型帮我生成一段处理「快速移入移出导致光标状态错乱」的防抖逻辑。这些请求如果分别走不同厂商的 APIKey 就得在好几个后台之间来回找调试期特别烦。TaoToken 在这里的作用是提供一个统一的 API 通道把多个模型的调用收敛到一个 Base URL 和一把 Key 上。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个不加 UTM。你可以在它的控制台里生成 Key然后在 Cursor、Cline 或者自己写的调试脚本里统一配置。为什么调试 Unity 脚本时这个统一通道有用因为交互逻辑的边界情况特别多。比如「鼠标从按钮 A 快速划到按钮 B中间经过了空白区域」这时候OnPointerExit和OnPointerEnter的触发顺序在不同 Unity 版本里表现不完全一致我一般会让模型帮我分析事件顺序再自己写个日志验证。不同模型对这类问题的回答角度不一样有的偏理论、有的直接给代码多问几个模型交叉验证比死磕一个靠谱。而统一 Key 之后切换模型只需要改一个 model 字段不用重新配 Key。具体操作上你可以在 TaoToken 控制台创建 API Key然后在你常用的 AI 编程工具里把 Base URL 指向https://taotoken.net/apiKey 填进去。如果你用的是 Cursor就在设置里找 OpenAI 兼容的自定义模型入口如果用 Cline 这类插件配置项里同样有 Base URL 和 API Key 两栏。模型 ID 按你实际要用的填比如调试 C# 逻辑时选一个擅长代码的模型即可。这里要强调一点TaoToken 是帮你管理调用通道的不是替代 Unity 编辑器也不是让你把生产环境的数据库直连上去。它就是个调试期的模型调用入口定位清楚用起来才踏实。我自己的习惯是Unity 项目里的 AI 辅助只用于「查文档、生成样板代码、分析报错」核心交互逻辑还是自己写、自己测。配置好之后你在调试光标脚本时遇到NullReferenceException或者光标不生效可以直接把报错和代码片段丢给模型让它帮你定位。比在搜索引擎里翻半天旧帖子快得多。下面进入正题先看光标资源怎么导入。3. 光标资源导入与 MouseEnterOrExit 脚本可复制配置这一步是整个实现的基础资源没配对脚本写得再对也没用。我按「导入图片 → 改类型 → 建脚本 → 挂载」的顺序来每一步都给可复制的配置。3.1 光标贴图导入配置先把你的光标图片拖进 Unity 工程。建议放在Assets/Resources/Cursors/目录下因为后面要用Resources.Load动态加载路径写起来干净。选中图片在 Inspector 里改几个关键项配置项值说明Texture TypeCursor不改这个SetCursor会报错Max Size32Unity 硬件光标上限就是 32×32Alpha Is Transparency勾选避免边缘黑边Wrap ModeClamp防止采样溢出改完点 Apply。这里有个实测细节如果你的原图是 64×64 甚至更大Max Size 设 32 之后 Unity 会自动缩到 32×32但缩放算法可能让图形变糊。我的做法是直接在美术工具里导出两张 32×32 的图——一张正常大小的小手一张图形占满画布的小手视觉上就是「放大版」。这样两张图都是 32×32符合 Unity 限制但看起来尺寸不同。注意Unity 硬件光标最小和最大都是 32×32至少在我用过的版本里是这样你没法通过 SetCursor 传一个 64×64 的图让它变大。所谓「改变大小」本质是换一张图形占比不同的贴图。3.2 MouseEnterOrExit 脚本新建 C# 脚本命名MouseEnterOrExit完整代码如下可以直接复制using UnityEngine; using UnityEngine.EventSystems; public class MouseEnterOrExit : MonoBehaviour, IPointerEnterHandler, IPointerExitHandler { [Header(光标贴图)] public Texture2D normalCursor; // 普通光标 public Texture2D hoverCursor; // 悬停放大光标 [Header(热点坐标)] public Vector2 hotspot Vector2.zero; private static bool isHovering false; public void OnPointerEnter(PointerEventData eventData) { if (isHovering) return; isHovering true; ApplyCursor(hoverCursor); } public void OnPointerExit(PointerEventData eventData) { if (!isHovering) return; isHovering false; ApplyCursor(normalCursor); } private void ApplyCursor(Texture2D tex) { if (tex null) { Cursor.SetCursor(null, Vector2.zero, CursorMode.Auto); return; } Cursor.SetCursor(tex, hotspot, CursorMode.Auto); } private void OnDisable() { // 对象被禁用时还原避免光标卡在悬停状态 if (isHovering) { isHovering false; Cursor.SetCursor(null, Vector2.zero, CursorMode.Auto); } } }几个设计点解释一下。isHovering用 static 是为了防止多个按钮同时触发时状态打架虽然简单但在快速划过多按钮时能减少闪烁。OnDisable里还原光标很关键——如果你的按钮会被动态隐藏比如切页签不还原的话光标会一直停在放大状态玩家会以为卡了。hotspot是热点坐标也就是光标的「点击判定点」一般小手图标设成(0,0)或图形指尖位置设错了点击会偏移。3.3 挂载与赋值把脚本挂到你的 Button 上然后在 Inspector 里把两张 Cursor 贴图拖到normalCursor和hoverCursor字段。如果你用 Resources 动态加载也可以改成在Start里Resources.LoadTexture2D(Cursors/hand_normal)。挂载完成后Button 本身还需要能接收射线——确认 Canvas 上有Graphic RaycasterButton 的Raycast Target是勾选的。如果你在调试期用 AI 帮你改这段脚本比如想加一个「不同按钮用不同光标」的扩展可以把这段代码贴给模型让它基于ScriptableObject做配置化。这时候统一 Key 的好处就体现出来了切模型不用重配。4. Play 模式验证请求与成功结果脚本挂好、贴图配好接下来就是验证。我按「静态检查 → Play 模式 → 边界测试」三步走每步都有明确的预期结果。4.1 静态检查点 Play 之前先在 Inspector 里确认三件事脚本的两个贴图字段都不为 None贴图的 Texture Type 确实是 CursorButton 的 Interactable 是勾选的。如果贴图字段是空的运行后移入按钮光标不会变但也不报错很容易误以为脚本没生效。4.2 Play 模式验证点 Play把鼠标移到按钮上。预期结果是光标立刻变成hoverCursor那张放大版小手。移开按钮光标还原成normalCursor或系统默认。如果没变化先看 Console 有没有报错再检查贴图类型。我实测下来最容易出问题的是贴图类型没改。Unity 对非 Cursor 类型的贴图调用SetCursor时行为是「静默失败」——不报错但光标不变。所以如果你发现脚本逻辑都对、就是不生效第一件事就是回去看 Texture Type。4.3 边界测试正常移入移出通过后测几个边界情况。快速在多个按钮之间来回划看光标有没有闪烁或卡住把按钮所在的父物体 SetActive(false)看光标有没有还原这就是OnDisable的作用在按钮边缘反复进出看状态是否稳定。这几个场景过了基本就能上项目了。如果你在验证过程中遇到报错比如NullReferenceException指向ApplyCursor那多半是贴图字段没赋值。把报错和脚本贴给模型分析比自己一行行看快。统一 Key 通道下你可以让不同模型分别给排查思路交叉验证。5. 本篇常见错误排查401、local proxy failed 与光标不生效调试期的问题分两类一类是 Unity 光标本身的一类是 AI 调用通道的。分开说。5.1 光标相关报错光标完全不变化九成是 Texture Type 没改成 Cursor。回 Inspector 改Apply重进 Play。其次是贴图字段为空检查 Inspector 赋值。光标变了但点击位置偏移热点坐标hotspot设错了。小手指尖一般在图片左上角附近试着设成(0, 0)或(4, 4)微调。热点是相对贴图左上角的像素坐标不是归一化的。移出后光标不还原检查OnPointerExit有没有被触发。如果按钮被其他 UI 遮挡Exit 可能不触发。另外确认OnDisable里的还原逻辑在防止对象隐藏后光标卡住。多个按钮状态打架如果你没用 static 标记或者没做防抖快速划过多个按钮时光标会闪。上面的脚本用isHovering静态标记做了简单防护复杂场景可以改成引用计数。5.2 AI 调用通道报错如果你在调试时用 TaoToken 统一通道调模型可能遇到这几类报错401 UnauthorizedKey 没填对或者过期了。去控制台重新生成一个注意别把 Key 里的字符复制漏了。Base URL 确认是https://taotoken.net/api不要多加斜杠或路径。local proxy failed这类报错通常是你本地网络配置或者工具里的代理设置有问题。检查你的 AI 工具里有没有多余的代理配置清掉让它直连 Base URL。注意这里说的是工具自身的网络设置不是让你去搞什么网络加速就是检查配置项有没有填错。reading choices 相关报错一般是返回体格式和工具预期不匹配。确认你填的模型 ID 是通道支持的别填一个不存在的模型名。如果工具要求 OpenAI 兼容格式确认请求路径拼对了。OAuth 相关报错如果你用的是需要 OAuth 的工具确认授权流程走完了。有些工具会缓存旧 token清一下缓存重新授权。排查这类问题的通用思路先确认 Base URL 和 Key 两栏填对再确认模型 ID 存在最后看工具的网络配置有没有多余项。把完整报错贴给模型让它帮你逐条对照比瞎试快。注意以上排查针对的是 AI 工具调用通道的配置问题和 Unity 光标逻辑无关。两类问题分开定位别混在一起查。6. 接入文档与模型对话入口光标脚本跑通之后如果你想把调试期的 AI 辅助流程也固定下来可以去 TaoToken 控制台生成一把长期用的 Key然后在你的编程工具里配好 Base URL 和模型 ID。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各工具的配置示例。API Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。如果你长期做 Unity 开发、经常需要 AI 辅助写交互逻辑和排查报错可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。最后补一个我踩过的坑光标贴图如果带了半透明边缘在某些分辨率下会出现黑边勾选 Alpha Is Transparency 能缓解。另外如果你要做「移入放大」的动画过渡硬件光标做不到平滑缩放只能两张图硬切。想要平滑效果就得改用软件光标方案——自己画一个 Image 跟随鼠标用 DOTween 做缩放。这个方案自由度更高但要多处理一层坐标转换适合对视觉要求高的项目。硬件光标方案胜在简单、性能好大部分按钮反馈场景够用了。