1. 控制台光标闪烁到底烦在哪写 C 命令行工具的人大概率都遇到过这个场景程序在终端里画进度条、刷表格、做字符动画结果光标一直杵在那儿闪视觉上特别割裂。尤其是做终端 UI 的时候光标闪烁会直接破坏整个界面的沉浸感。这个问题在 Windows 和 Linux 上的表现还不一样Windows 控制台有自己的 APILinux 终端则要靠 ANSI 转义序列跨平台代码写起来很容易顾此失彼。我这次要聊的就是怎么在 C 里把控制台光标藏起来并且让同一套代码在 Windows 和 Linux 下行为一致。核心思路是把平台相关的实现封装成一个统一接口再配合 TaoToken 的统一 Key/API 通道做配置管理这样你在不同机器上编译运行时不用改代码就能拿到相同的终端行为。适合谁看写 CLI 工具、终端仪表盘、字符动画、TUI 框架的开发者以及需要跨平台交付命令行程序的团队。隐藏光标本身不复杂难的是「跨平台一致」和「配置可复现」。很多人写完 Windows 版本换到 Linux 就发现光标还在闪或者反过来。下面我会给出可复制的 config.toml 骨架、TaoToken 的接入配置以及编译运行后的验证动作确保你两边都能对上。2. TaoToken 前置统一 Key 与 API 通道在动手写代码之前先把配置通道理顺。TaoToken 在这里扮演的角色是统一管理你的 API Key 和模型调用入口方便你在 CLI 工具里集成对话、代码补全等能力时不用每个平台单独维护一套凭证。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要先拿到一个可用的 Key。进入控制台创建 API Key地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建完之后把 Key 写进本地配置文件不要硬编码进源码。如果你后面要做长期编码或者 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 里面有完整的请求格式说明。模型对话的调试入口是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 你可以先在网页上验证模型是否正常响应再写进 C 代码里。注意Key 属于敏感凭证建议通过环境变量或本地 config.toml 注入不要提交到版本库。3. 可复制配置config.toml 骨架与跨平台隐藏光标实现3.1 config.toml 骨架先给出配置文件骨架放在项目根目录或者用户配置目录下都行。这个文件同时承载 TaoToken 的接入信息和终端行为开关。# config.toml [taotoken] api_base https://taotoken.net/api api_key sk-你的Key model gpt-4o-mini timeout_ms 30000 [terminal] hide_cursor true restore_on_exit true platform auto # auto | windows | posixplatform auto表示让代码自己判断当前系统你也可以强制指定方便调试。restore_on_exit控制程序退出时是否恢复光标这个在异常退出场景下很重要后面排障会讲。3.2 Windows 实现Windows 控制台用SetConsoleCursorInfo核心是把bVisible设为FALSE。注意结构体初始化时dwSize不能为 0否则调用会失败。// cursor_win.h #pragma once #ifdef _WIN32 #include windows.h inline void HideCursorWin() { CONSOLE_CURSOR_INFO info; info.dwSize 1; // 不能为 0 info.bVisible FALSE; SetConsoleCursorInfo(GetStdHandle(STD_OUTPUT_HANDLE), info); } inline void ShowCursorWin() { CONSOLE_CURSOR_INFO info; info.dwSize 1; info.bVisible TRUE; SetConsoleCursorInfo(GetStdHandle(STD_OUTPUT_HANDLE), info); } #endif3.3 Linux / POSIX 实现Linux 终端靠 ANSI 转义序列隐藏是\033[?25l显示是\033[?25h。写的时候记得 flush否则可能不生效。// cursor_posix.h #pragma once #ifndef _WIN32 #include cstdio inline void HideCursorPosix() { std::fputs(\033[?25l, stdout); std::fflush(stdout); } inline void ShowCursorPosix() { std::fputs(\033[?25h, stdout); std::fflush(stdout); } #endif3.4 统一封装把两个平台包成一个接口调用方不用关心底层差异。// cursor.h #pragma once #include cursor_win.h #include cursor_posix.h class CursorGuard { public: CursorGuard() { #ifdef _WIN32 HideCursorWin(); #else HideCursorPosix(); #endif } ~CursorGuard() { #ifdef _WIN32 ShowCursorWin(); #else ShowCursorPosix(); #endif } CursorGuard(const CursorGuard) delete; CursorGuard operator(const CursorGuard) delete; };用 RAII 的好处是哪怕程序中途抛异常析构函数也会把光标恢复回来。这比手动调ShowCursor靠谱得多。3.5 主程序示例// main.cpp #include iostream #include thread #include chrono #include cursor.h int main() { CursorGuard guard; // 构造即隐藏 for (int i 0; i 100; i 10) { std::cout \r进度: i % std::flush; std::this_thread::sleep_for(std::chrono::milliseconds(200)); } std::cout \n完成\n; return 0; // 析构自动恢复 }编译命令# Linux g -stdc17 -O2 main.cpp -o demo # Windows (MSVC) cl /std:c17 /EHsc main.cpp /Fe:demo.exe4. 验证请求与成功结果4.1 验证光标状态跑起来之后观察进度条刷新时终端里有没有闪烁的方块或竖线。如果隐藏成功你只会看到百分比数字在变光标不出现。程序结束后光标应该自动恢复。Linux 下可以用tput civis和tput cnorm做对照测试确认你的终端支持 ANSI 序列tput civis # 隐藏 sleep 2 tput cnorm # 恢复Windows 下如果用的是 Windows TerminalANSI 序列同样有效如果是老式 conhost走SetConsoleCursorInfo更稳。4.2 验证 TaoToken 通道写一个最小请求确认 Key 和 API 通道可用。用 curl 先测curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里能看到choices字段就说明通道正常。你也可以直接在模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 里发一条消息确认账号状态。4.3 预期结果对照检查项WindowsLinux光标隐藏进度条刷新无闪烁进度条刷新无闪烁退出恢复光标重新出现光标重新出现异常退出RAII 析构恢复RAII 析构恢复API 通道返回 choices返回 choices5. 本篇常见错排查5.1 光标没隐藏最常见的原因是CONSOLE_CURSOR_INFO的dwSize设成了 0。Windows 要求这个值在 1 到 100 之间设 0 会导致SetConsoleCursorInfo返回失败但很多人不检查返回值以为生效了。加一行判断if (!SetConsoleCursorInfo(GetStdHandle(STD_OUTPUT_HANDLE), info)) { std::cerr 隐藏光标失败, 错误码: GetLastError() \n; }Linux 下如果没生效检查输出是不是被重定向了。ANSI 序列写到文件里不会报错但终端看不到效果。5.2 程序崩溃后光标不恢复如果没用 RAII而是手动在main末尾调ShowCursor一旦中间抛异常或者exit()被调用恢复逻辑就跳过了。解决办法就是前面给的CursorGuard把恢复动作绑在析构上。另外可以注册std::atexit做兜底。5.3 跨平台编译报错cursor_win.h里用了windows.h在 Linux 下会直接编译失败。所以头文件里必须用#ifdef _WIN32包住并且统一封装的头文件要同时包含两个平台的头靠宏切换。如果你用的是 CMake可以按平台条件编译if(WIN32) target_sources(demo PRIVATE cursor_win.h) else() target_sources(demo PRIVATE cursor_posix.h) endif()5.4 API 请求 401先确认 Key 有没有多余空格再确认请求头是Authorization: Bearer sk-xxx格式。如果还是 401去控制台 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 重新生成一个 Key 试试。接入细节以文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 为准。5.5 终端类型不兼容有些精简终端或者 CI 环境不支持 ANSI 序列这时候隐藏光标会失效但不报错。可以在代码里加一个环境变量开关比如NO_CURSOR_HIDE1时跳过隐藏逻辑避免在日志环境里输出乱码。6. 把配置和代码一起管起来跨平台隐藏光标这件事代码本身不到五十行真正花时间的是配置管理和验证流程。我的建议是把config.toml纳入项目模板Key 用环境变量覆盖终端行为开关按平台自动判断。这样你在 Windows 上编译完直接把同一份代码拿到 Linux 上g一下就能跑行为一致。如果你后面要在 CLI 工具里集成模型能力长期编码场景可以走 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite Key 管理统一在控制台 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 处理。调试模型响应的时候模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 比写代码快得多。接入格式有疑问就翻文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API 入口固定是 https://taotoken.net/api 。最后留一个实用技巧在CursorGuard里加一个静态计数器支持嵌套使用。比如你的程序里多个模块都要隐藏光标嵌套构造时只在最外层真正隐藏析构时也只在最外层恢复避免中间层提前把光标放出来。这个在大型 TUI 项目里能省不少事。