rust-ctrlc 快速入门：5 分钟让 Rust CLI 程序优雅响应 Ctrl-C

rust-ctrlc 快速入门：5 分钟让 Rust CLI 程序优雅响应 Ctrl-C

【免费下载链接】rust-ctrlcEasy Ctrl-C handler for Rust projects项目地址: https://gitcode.com/gh_mirrors/ru/rust-ctrlc

当用户按下Ctrl-C时，你的 Rust 命令行程序会立刻被系统强制终止，正在写入的数据可能损坏、临时文件可能残留——这几乎是每个 Rust CLI 开发者都会遇到的痛点。rust-ctrlc就是为解决这个问题而生的轻量级库，它提供一个简单易用的Rust Ctrl-C 信号处理接口，只需一个回调函数，就能让程序在收到中断信号时优雅地完成收尾工作。无论你是 Rust 新手还是老手，掌握这个Rust 信号处理技巧都只需要 5 分钟。

为什么需要优雅处理 Ctrl-C 信号？

先看一个典型场景：你的程序正在写日志、保存进度或上传文件，用户突然按下Ctrl+C，进程直接退出，数据可能丢失一半。更糟的是，程序可能来不及清理临时文件或释放资源。

rust-ctrlc正是为此而生：它在后台开启一个专用的信号处理线程，收到信号后执行你预先写好的清理逻辑，让程序「善始善终」。

快速开始：只需两步添加依赖

第一步，在Cargo.toml中加入依赖：

[dependencies] ctrlc = "3.5"

第二步，在你的src/lib.rs或main.rs中调用ctrlc::set_handler注册回调即可。库的入口实现就在项目的 src/lib.rs 中，核心 API 一目了然。

最简单的用法：一个标志位搞定

如果你只是想「收到 Ctrl-C 后让主循环停下来」，用AtomicBool就够了：

use std::sync::atomic::{AtomicBool, Ordering}; use std::sync::Arc; fn main() { let running = Arc::new(AtomicBool::new(true)); let r = running.clone(); ctrlc::set_handler(move || { r.store(false, Ordering::SeqCst); }).expect("Error setting Ctrl-C handler"); println!("Waiting for Ctrl-C..."); while running.load(Ordering::SeqCst) {} println!("Got it! Exiting..."); }

主循环每秒检查一次标志位，收到信号后自然退出，全程无阻塞、无 panic。

进阶用法：用通道传递消息

如果你需要在回调里把事件「发出去」，配合std::sync::mpsc通道是最经典的模式，这也是项目自带示例 examples/readme_example.rs 的写法：

use std::sync::mpsc::channel; fn main() { let (tx, rx) = channel(); ctrlc::set_handler(move || tx.send(()).expect("Could not send signal on channel.")) .expect("Error setting Ctrl-C handler"); println!("Waiting for Ctrl-C..."); rx.recv().expect("Could not receive from channel."); println!("Got it! Exiting..."); }

主线程在rx.recv()上等待，收到 Ctrl-C 后回调向通道发送消息，主线程随即继续执行收尾逻辑。想本地跑一遍，直接执行cargo build --examples && target/debug/examples/readme_example。

如何一次性优雅退出：连续按两次 Ctrl-C

用户经常手滑连按两次 Ctrl-C。更聪明的做法是：第一次触发收尾逻辑，第二次强制退出。项目示例 examples/issue_46_example.rs 展示了这个「双保险」模式：

let running = Arc::new(AtomicUsize::new(0)); let r = running.clone(); ctrlc::set_handler(move || { let prev = r.fetch_add(1, Ordering::SeqCst); if prev == 0 { println!("Exiting..."); } else { process::exit(0); } }).expect("Error setting Ctrl-C handler");

第一次 Ctrl-C 打印提示并开始收尾，第二次直接退出，既给了程序缓冲时间，也保证用户随时能强制终止，体验非常友好。

还想处理 SIGTERM 和 SIGHUP？开启 termination feature

如果你的程序运行在服务器上，还会收到kill命令发出的SIGTERM信号、终端断开时的SIGHUP信号。rust-ctrlc 提供了terminationfeature，一键扩展：

[dependencies] ctrlc = { version = "3.5", features = ["termination"] }

开启后，同一个回调会自动处理SIGINT、SIGTERM和SIGHUP三种信号，跨平台的行为细节定义在 src/signal.rs 中，Windows 平台还额外映射了控制台关闭事件，相关实现见 src/platform/windows/mod.rs 与 src/platform/unix/mod.rs。

新手最容易踩的 3 个坑

• 只能注册一个 handler：set_handler只能调用一次，重复调用会返回MultipleHandlers错误。如果需要更精细的多种信号控制，可以了解try_set_handler或更底层的 signal-hook 类库。
• 回调里别做重活：回调运行在专用信号线程中，应保持轻量（发个消息、置个标志位），耗时操作交给主线程完成。
• 错误处理别忽略：set_handler返回Result，系统调用失败时会返回具体的错误信息（见 src/error.rs），务必用expect或?处理。

总结

rust-ctrlc 用极低的成本解决了 Rust CLI 程序「优雅退出」这个高频需求：一个函数、一个回调、跨平台开箱即用。想亲手体验，可以git clone https://gitcode.com/gh_mirrors/ru/rust-ctrlc查看完整源码与测试用例，立刻让你的命令行工具变得专业又可靠 🚀

【免费下载链接】rust-ctrlcEasy Ctrl-C handler for Rust projects项目地址: https://gitcode.com/gh_mirrors/ru/rust-ctrlc