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 信号先看一个典型场景你的程序正在写日志、保存进度或上传文件用户突然按下CtrlC进程直接退出数据可能丢失一半。更糟的是程序可能来不及清理临时文件或释放资源。rust-ctrlc正是为此而生它在后台开启一个专用的信号处理线程收到信号后执行你预先写好的清理逻辑让程序「善始善终」。默认行为使用 rust-ctrlc 后进程被直接杀死无任何回调触发你的回调函数可保存状态、清理资源无法控制退出流程可选择在回调中直接退出或先收尾再退出仅支持 Ctrl-C开启 feature 后还可处理 SIGTERM、SIGHUP快速开始只需两步添加依赖第一步在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 个坑只能注册一个 handlerset_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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考