尧图网站建设 
1. 从屏保程序说起C# 隐藏光标到底难在哪给班级做屏保、做展厅大屏、做收银台待机界面这类需求有个共同点鼠标指针必须消失。我一开始也觉得这事简单Cursor.Hide()一行不就完了真动手才发现坑不少光标藏了但一动鼠标又冒出来、程序退出后光标没恢复、多显示器下只隐藏了主屏、全屏切换时闪烁。先说清楚本文要解决什么。C# 隐藏光标指的是在 Windows 窗体程序WinForms运行时让鼠标指针不可见适合做屏保、Kiosk 展示、教学演示、工业看板这类不需要用户点击的场景。适合谁看刚学 WinForms 的初学者、需要快速交付展示程序的开发者、以及想顺手把开发环境里的模型调用通道统一起来的同学。为什么很多人搜到的方法不好用因为网上大量答案混用了 Win32 APIShowCursor、WPF 的Mouse.OverrideCursor、以及 WinForms 的Cursor.Hide()三者作用域完全不同。ShowCursor是全局计数器调一次减一调多了光标就再也回不来Cursor.Hide()是 WinForms 层面的作用在当前控件区域相对安全。选错 API就会出现隐藏成功但恢复不了的尴尬。这篇我会用最朴素的 WinForms 项目把Cursor.Hide()的完整用法、恢复时机、边界情况讲透同时把开发过程中用到的模型调用通道TaoToken 统一 Key配置好方便你后续给程序加 AI 能力时不用再折腾环境。全程可复制编译即跑。2. TaoToken 统一 Key 前置把开发环境通道先理顺在写隐藏光标代码之前先把开发环境里那条模型调用通道配好。原因很实际屏保程序做完下一步往往要加个 AI 问答、语音提示、或者自动生成展示文案这时候如果没有统一的 Key 管理你会在多个 SDK 之间反复填 Base URL 和密钥很容易配错。TaoToken 在这里扮演的角色是统一 Key 与 API 通道你申请一个 Key就能通过同一套接口访问不同模型不用为每个模型单独维护一套鉴权配置。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个地址不加 UTM 参数配置时直接用它。具体操作路径先到控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后如果你只是想先验证模型能不能通用模型对话页面最快 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。这里要强调一个概念Base URL Key Model ID 三件套。不管你后面用 Cline、Codex 还是 Claude Code配置项永远是这三个。Base URL 填https://taotoken.net/apiKey 填你创建的那串Model ID 填你要用的模型名。三件套对齐了请求才发得出去。注意Key 属于敏感信息不要硬编码进提交到 Git 的源码里。WinForms 项目里建议放在App.config或环境变量后面第 3 节会给可复制的配置片段。如果你打算长期在这个项目上做编码和 Agent 类开发可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题先查文档比到处搜快。环境通道理顺后回到正题隐藏光标。3. 可复制配置Cursor.Hide 代码与 TaoToken 配置片段先建项目。打开 Visual Studio新建Windows 窗体应用(.NET Framework)目标框架选 .NET Framework 4.7.2 或更高都行。项目建好后把主窗体Form1的代码替换成下面这份我加了详细注释直接复制能跑。using System; using System.Drawing; using System.Windows.Forms; namespace HideCursorDemo { public partial class Form1 : Form { private Timer _cursorTimer; private bool _cursorHidden false; public Form1() { InitializeComponent(); this.Text 隐藏光标演示; this.Size new Size(800, 600); this.StartPosition FormStartPosition.CenterScreen; this.BackColor Color.Black; // 用定时器周期性隐藏防止鼠标移动后光标重新出现 _cursorTimer new Timer(); _cursorTimer.Interval 100; // 100ms 检查一次 _cursorTimer.Tick (s, e) { if (!_cursorHidden) { Cursor.Hide(); // 隐藏光标 _cursorHidden true; } }; _cursorTimer.Start(); // 鼠标移动时重新隐藏有些场景移动会让光标复现 this.MouseMove (s, e) { if (_cursorHidden) { Cursor.Hide(); } }; } // 窗体关闭时务必恢复光标否则整个系统光标可能异常 protected override void OnFormClosing(FormClosingEventArgs e) { _cursorTimer.Stop(); Cursor.Show(); // 恢复光标 base.OnFormClosing(e); } } }核心就一句Cursor.Hide()但恢复同样重要。Cursor.Show()必须放在窗体关闭事件里否则程序退出后光标可能一直不显示用户会以为系统坏了。这是我踩过的坑早期版本忘了恢复测试机重启才恢复正常。接下来是 TaoToken 的配置片段。WinForms 项目里推荐用App.config存 Base URL 和 Model IDKey 走环境变量。App.config内容如下?xml version1.0 encodingutf-8? configuration appSettings add keyTaoTokenBaseUrl valuehttps://taotoken.net/api / add keyTaoTokenModelId valueyour-model-id / /appSettings /configuration读取配置的代码using System.Configuration; string baseUrl ConfigurationManager.AppSettings[TaoTokenBaseUrl]; string modelId ConfigurationManager.AppSettings[TaoTokenModelId]; string apiKey Environment.GetEnvironmentVariable(TAOTOKEN_API_KEY);如果你用的是支持 JSON 配置的工具链比如某些 Agent 客户端对应的settings.json片段长这样{ baseUrl: https://taotoken.net/api, apiKey: 从环境变量读取, modelId: your-model-id }三件套对齐后你的 WinForms 程序后续要加 AI 能力直接复用这套配置即可不用再改代码里的地址。4. 验证请求与成功结果编译运行看光标是否真的消失配置和代码都齐了现在验证。步骤分三步编译、运行、观察。第一步编译。在 Visual Studio 里按CtrlShiftB或者命令行进项目目录执行dotnet build HideCursorDemo.csproj如果用的是 .NET Framework 老项目用 MSBuildmsbuild HideCursorDemo.csproj /p:ConfigurationRelease编译成功会输出Build succeeded或生成成功。如果报Cursor找不到检查是否引用了System.Windows.Forms程序集。第二步运行。直接F5启动或者到bin\Debug目录双击 exe。窗体出现后把鼠标移到黑色窗体区域内观察指针——正常情况下指针应该消失。移动鼠标指针依然不出现因为MouseMove里又调了一次Cursor.Hide()。第三步验证恢复。关闭窗体回到桌面移动鼠标指针应该正常显示。如果没恢复说明OnFormClosing没执行到检查是否被异常中断。成功结果长这样窗体全黑鼠标移进去指针消失移出窗体到桌面指针恢复关闭程序后系统光标一切正常。整个过程不需要重启不需要改注册表。如果你还想验证 TaoToken 通道是否通可以在程序里加一个按钮点击后发一个测试请求。用HttpClient发到https://taotoken.net/api带上 Key 和 Model ID返回 200 且有内容就说明通道正常。这一步不是隐藏光标的必需项但能帮你确认环境配置没白做。提示测试请求建议放在单独的调试按钮里不要混进屏保主逻辑避免网络异常影响展示效果。5. 常见报错排查401、local proxy failed 与光标不恢复这一节列几个真实会遇到的报错对照着查。报错一401 Unauthorized。这是 Key 问题。检查三件事Key 是否复制完整前后有没有空格、环境变量名是否和代码里读的一致、Key 是否已过期。TaoToken 的 Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 进去重新生成一个再试。注意 Base URL 必须是https://taotoken.net/api多一个斜杠或少一个路径都会 401。报错二local proxy failed。这个通常出现在你本地配了转发工具的场景。排查方向检查本地端口是否被占用、配置里的地址是否写成了localhost而实际服务没起。把 Base URL 直接改成https://taotoken.net/api走直连多数情况能绕过。如果还不行看接入文档里的网络配置章节 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。报错三reading choices 相关解析错误。这类报错说明请求发出去了但返回结构和你代码里解析的字段对不上。常见原因是 Model ID 填错或者你按某个特定模型的返回格式写死了解析逻辑。解决方式先用模型对话页面确认该 Model ID 能正常返回再对照文档调整解析代码。报错四OAuth 相关失败。如果你用的是 Claude Code 这类需要 OAuth 的工具报 OAuth 错误时先确认工具版本再检查配置里是否同时填了 Key 和 OAuth 两套鉴权。两者选其一即可混填会冲突。Claude Code 的接入说明在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。光标不恢复。这是隐藏光标场景特有的问题。原因通常是Cursor.Show()没被调用或者调用了但被其他Cursor.Hide()抵消。检查OnFormClosing是否真的执行可以在里面加MessageBox.Show(closing)调试。另外如果你在多个地方调了Cursor.Hide()记得配对调用Cursor.Show()数量要一致。光标隐藏后闪烁。定时器间隔太短或太长都会闪。100ms 是实测比较稳的值你可以根据自己屏幕刷新率微调。如果还闪把MouseMove里的重复隐藏去掉只靠定时器。6. 继续往下走把通道用起来隐藏光标这件事本身到第 5 节就结束了代码能跑、光标能藏能恢复、报错能查。剩下的是怎么把这套环境继续用起来。如果你只是偶尔验证模型输出用模型对话页面最省事 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你要在 WinForms 项目里长期加 AI 功能比如自动生成屏保文案、语音播报、图像识别那就把第 3 节的配置片段固化到项目里Key 走环境变量Base URL 和 Model ID 走配置文件。长期做编码和 Agent 类开发的话Coding Plan 值得看一眼 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数问题先翻文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 比在搜索引擎里翻半天快。最后留个实用技巧屏保程序里隐藏光标最好同时禁用鼠标点击和键盘输入否则用户误触会打断展示。禁用输入可以用this.Enabled false配合全局钩子但钩子要谨慎用容易和杀毒软件冲突。简单做法是让窗体全屏置顶光标隐藏用户点不到其他东西展示结束按Esc退出。这个组合我在班级屏保上跑了一学期没出过问题。 C#隐藏光标最简单的方法：TaoToken 统一 Key 接入 Windows 窗体程序
1. 从屏保程序说起C# 隐藏光标到底难在哪给班级做屏保、做展厅大屏、做收银台待机界面这类需求有个共同点鼠标指针必须消失。我一开始也觉得这事简单Cursor.Hide()一行不就完了真动手才发现坑不少光标藏了但一动鼠标又冒出来、程序退出后光标没恢复、多显示器下只隐藏了主屏、全屏切换时闪烁。先说清楚本文要解决什么。C# 隐藏光标指的是在 Windows 窗体程序WinForms运行时让鼠标指针不可见适合做屏保、Kiosk 展示、教学演示、工业看板这类不需要用户点击的场景。适合谁看刚学 WinForms 的初学者、需要快速交付展示程序的开发者、以及想顺手把开发环境里的模型调用通道统一起来的同学。为什么很多人搜到的方法不好用因为网上大量答案混用了 Win32 APIShowCursor、WPF 的Mouse.OverrideCursor、以及 WinForms 的Cursor.Hide()三者作用域完全不同。ShowCursor是全局计数器调一次减一调多了光标就再也回不来Cursor.Hide()是 WinForms 层面的作用在当前控件区域相对安全。选错 API就会出现隐藏成功但恢复不了的尴尬。这篇我会用最朴素的 WinForms 项目把Cursor.Hide()的完整用法、恢复时机、边界情况讲透同时把开发过程中用到的模型调用通道TaoToken 统一 Key配置好方便你后续给程序加 AI 能力时不用再折腾环境。全程可复制编译即跑。2. TaoToken 统一 Key 前置把开发环境通道先理顺在写隐藏光标代码之前先把开发环境里那条模型调用通道配好。原因很实际屏保程序做完下一步往往要加个 AI 问答、语音提示、或者自动生成展示文案这时候如果没有统一的 Key 管理你会在多个 SDK 之间反复填 Base URL 和密钥很容易配错。TaoToken 在这里扮演的角色是统一 Key 与 API 通道你申请一个 Key就能通过同一套接口访问不同模型不用为每个模型单独维护一套鉴权配置。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个地址不加 UTM 参数配置时直接用它。具体操作路径先到控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后如果你只是想先验证模型能不能通用模型对话页面最快 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。这里要强调一个概念Base URL Key Model ID 三件套。不管你后面用 Cline、Codex 还是 Claude Code配置项永远是这三个。Base URL 填https://taotoken.net/apiKey 填你创建的那串Model ID 填你要用的模型名。三件套对齐了请求才发得出去。注意Key 属于敏感信息不要硬编码进提交到 Git 的源码里。WinForms 项目里建议放在App.config或环境变量后面第 3 节会给可复制的配置片段。如果你打算长期在这个项目上做编码和 Agent 类开发可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题先查文档比到处搜快。环境通道理顺后回到正题隐藏光标。3. 可复制配置Cursor.Hide 代码与 TaoToken 配置片段先建项目。打开 Visual Studio新建Windows 窗体应用(.NET Framework)目标框架选 .NET Framework 4.7.2 或更高都行。项目建好后把主窗体Form1的代码替换成下面这份我加了详细注释直接复制能跑。using System; using System.Drawing; using System.Windows.Forms; namespace HideCursorDemo { public partial class Form1 : Form { private Timer _cursorTimer; private bool _cursorHidden false; public Form1() { InitializeComponent(); this.Text 隐藏光标演示; this.Size new Size(800, 600); this.StartPosition FormStartPosition.CenterScreen; this.BackColor Color.Black; // 用定时器周期性隐藏防止鼠标移动后光标重新出现 _cursorTimer new Timer(); _cursorTimer.Interval 100; // 100ms 检查一次 _cursorTimer.Tick (s, e) { if (!_cursorHidden) { Cursor.Hide(); // 隐藏光标 _cursorHidden true; } }; _cursorTimer.Start(); // 鼠标移动时重新隐藏有些场景移动会让光标复现 this.MouseMove (s, e) { if (_cursorHidden) { Cursor.Hide(); } }; } // 窗体关闭时务必恢复光标否则整个系统光标可能异常 protected override void OnFormClosing(FormClosingEventArgs e) { _cursorTimer.Stop(); Cursor.Show(); // 恢复光标 base.OnFormClosing(e); } } }核心就一句Cursor.Hide()但恢复同样重要。Cursor.Show()必须放在窗体关闭事件里否则程序退出后光标可能一直不显示用户会以为系统坏了。这是我踩过的坑早期版本忘了恢复测试机重启才恢复正常。接下来是 TaoToken 的配置片段。WinForms 项目里推荐用App.config存 Base URL 和 Model IDKey 走环境变量。App.config内容如下?xml version1.0 encodingutf-8? configuration appSettings add keyTaoTokenBaseUrl valuehttps://taotoken.net/api / add keyTaoTokenModelId valueyour-model-id / /appSettings /configuration读取配置的代码using System.Configuration; string baseUrl ConfigurationManager.AppSettings[TaoTokenBaseUrl]; string modelId ConfigurationManager.AppSettings[TaoTokenModelId]; string apiKey Environment.GetEnvironmentVariable(TAOTOKEN_API_KEY);如果你用的是支持 JSON 配置的工具链比如某些 Agent 客户端对应的settings.json片段长这样{ baseUrl: https://taotoken.net/api, apiKey: 从环境变量读取, modelId: your-model-id }三件套对齐后你的 WinForms 程序后续要加 AI 能力直接复用这套配置即可不用再改代码里的地址。4. 验证请求与成功结果编译运行看光标是否真的消失配置和代码都齐了现在验证。步骤分三步编译、运行、观察。第一步编译。在 Visual Studio 里按CtrlShiftB或者命令行进项目目录执行dotnet build HideCursorDemo.csproj如果用的是 .NET Framework 老项目用 MSBuildmsbuild HideCursorDemo.csproj /p:ConfigurationRelease编译成功会输出Build succeeded或生成成功。如果报Cursor找不到检查是否引用了System.Windows.Forms程序集。第二步运行。直接F5启动或者到bin\Debug目录双击 exe。窗体出现后把鼠标移到黑色窗体区域内观察指针——正常情况下指针应该消失。移动鼠标指针依然不出现因为MouseMove里又调了一次Cursor.Hide()。第三步验证恢复。关闭窗体回到桌面移动鼠标指针应该正常显示。如果没恢复说明OnFormClosing没执行到检查是否被异常中断。成功结果长这样窗体全黑鼠标移进去指针消失移出窗体到桌面指针恢复关闭程序后系统光标一切正常。整个过程不需要重启不需要改注册表。如果你还想验证 TaoToken 通道是否通可以在程序里加一个按钮点击后发一个测试请求。用HttpClient发到https://taotoken.net/api带上 Key 和 Model ID返回 200 且有内容就说明通道正常。这一步不是隐藏光标的必需项但能帮你确认环境配置没白做。提示测试请求建议放在单独的调试按钮里不要混进屏保主逻辑避免网络异常影响展示效果。5. 常见报错排查401、local proxy failed 与光标不恢复这一节列几个真实会遇到的报错对照着查。报错一401 Unauthorized。这是 Key 问题。检查三件事Key 是否复制完整前后有没有空格、环境变量名是否和代码里读的一致、Key 是否已过期。TaoToken 的 Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 进去重新生成一个再试。注意 Base URL 必须是https://taotoken.net/api多一个斜杠或少一个路径都会 401。报错二local proxy failed。这个通常出现在你本地配了转发工具的场景。排查方向检查本地端口是否被占用、配置里的地址是否写成了localhost而实际服务没起。把 Base URL 直接改成https://taotoken.net/api走直连多数情况能绕过。如果还不行看接入文档里的网络配置章节 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。报错三reading choices 相关解析错误。这类报错说明请求发出去了但返回结构和你代码里解析的字段对不上。常见原因是 Model ID 填错或者你按某个特定模型的返回格式写死了解析逻辑。解决方式先用模型对话页面确认该 Model ID 能正常返回再对照文档调整解析代码。报错四OAuth 相关失败。如果你用的是 Claude Code 这类需要 OAuth 的工具报 OAuth 错误时先确认工具版本再检查配置里是否同时填了 Key 和 OAuth 两套鉴权。两者选其一即可混填会冲突。Claude Code 的接入说明在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。光标不恢复。这是隐藏光标场景特有的问题。原因通常是Cursor.Show()没被调用或者调用了但被其他Cursor.Hide()抵消。检查OnFormClosing是否真的执行可以在里面加MessageBox.Show(closing)调试。另外如果你在多个地方调了Cursor.Hide()记得配对调用Cursor.Show()数量要一致。光标隐藏后闪烁。定时器间隔太短或太长都会闪。100ms 是实测比较稳的值你可以根据自己屏幕刷新率微调。如果还闪把MouseMove里的重复隐藏去掉只靠定时器。6. 继续往下走把通道用起来隐藏光标这件事本身到第 5 节就结束了代码能跑、光标能藏能恢复、报错能查。剩下的是怎么把这套环境继续用起来。如果你只是偶尔验证模型输出用模型对话页面最省事 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你要在 WinForms 项目里长期加 AI 功能比如自动生成屏保文案、语音播报、图像识别那就把第 3 节的配置片段固化到项目里Key 走环境变量Base URL 和 Model ID 走配置文件。长期做编码和 Agent 类开发的话Coding Plan 值得看一眼 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数问题先翻文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 比在搜索引擎里翻半天快。最后留个实用技巧屏保程序里隐藏光标最好同时禁用鼠标点击和键盘输入否则用户误触会打断展示。禁用输入可以用this.Enabled false配合全局钩子但钩子要谨慎用容易和杀毒软件冲突。简单做法是让窗体全屏置顶光标隐藏用户点不到其他东西展示结束按Esc退出。这个组合我在班级屏保上跑了一学期没出过问题。