如何在 Go 程序中屏蔽 Ctrl+C 触发的 "^C" 显示

如何在 Go 程序中屏蔽 Ctrl+C 触发的 "^C" 显示

本文介绍通过终端光标控制（回车符 \r）覆盖默认显示的 ^C 字符，实现在优雅捕获 SIGINT 信号的同时保持终端界面整洁。无需修改系统设置或依赖外部库，纯 Go 标准库即可实现。

在 Go 程序里监听 os.Interrupt（也就是 Ctrl+C）来处理程序退出，是个标准操作。但有个小麻烦：按下 Ctrl+C 后，终端总会自动显示一个 ^C 字符。这事儿是终端驱动层干的，Go 程序本身控制不了，所以想通过关日志或者忽略信号来让它消失，基本没戏。

那么，问题出在哪？关键在于，^C 的显示发生在信号被程序捕获之前，属于终端的本地回显行为。既然阻止不了它的产生，思路就得换一换：我们可以在信号处理逻辑里立刻把它覆盖掉。最直接有效的办法，就是利用 ASCII 回车符 \r，把光标挪到当前行的开头，然后用后续输出的内容（比如一句提示）把 ^C 盖过去。

下面是一个完整可运行的示例，清晰展示了如何实现：

package main

import (
    "fmt"
    "log"
    "os"
    "os/signal"
    "syscall"
    "time"
)

func main() {
    // 模拟长时间运行任务
    fmt.Println("Server started. Press Ctrl+C to exit...")
    done := make(chan bool)

    // 设置信号监听
    c := make(chan os.Signal, 1)
    signal.Notify(c, os.Interrupt, syscall.SIGTERM)

    go func() {
        <-c
        // 关键：用 \r 覆盖 ^C，并立即输出清理提示
        fmt.Print("\r") // 光标回到行首
        log.Println("Shutting down gracefully...")
        // 模拟清理工作（如关闭连接、保存状态等）
        time.Sleep(500 * time.Millisecond)
        fmt.Println("Goodbye!")
        done <- true
    }()

    // 主程序逻辑（此处仅阻塞等待）
    <-done
}

✅ 效果说明：

• 如果用户在 “Server started...” 这行末尾按下 Ctrl+C，终端原本会显示成 Server started. Press Ctrl+C to exit...^C；
• 加入 \r 后，光标会跳回行首，紧接着 log.Println(...) 的输出就会从行首开始，最终覆盖掉原来的显示，结果看起来就是：

Shutting down gracefully...
Goodbye!

⚠️ 注意事项：

• \r 只影响当前行。如果 ^C 出现在多行输出的中间，得确保后续输出的内容足够长，能完全覆盖掉它（不过通常一行提示语就足够了）；
• 避免在 \r 后面直接使用 fmt.Println()（因为它会换行）。推荐组合使用 fmt.Print("\r") 加 log.Println()，或者用 fmt.Printf("\r%s\n", msg)；
• 这个方案在绝大多数类 Unix 终端（Linux/macOS）以及 Windows Terminal 上都能用（PowerShell 或 CMD 在启用虚拟终端支持后也兼容）；
• 当然，它不适用于输出被重定向到文件的场景（因为那时程序没有终端控制能力），不过话说回来，^C 显示这个问题本身也只存在于交互式终端里。

总结一下，屏蔽 ^C 显示，本质上不是去“拦截信号回显”，而是一次“视觉修复”。借助 \r 这个轻量级的终端控制技巧，完全不需要引入 cgo 或者复杂的 TTY 操作，就能让命令行工具的专业度和用户体验提升一个档次。