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 信号先看一个典型场景你的程序正在写日志、保存进度或上传文件用户突然按下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），仅供参考

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

相关推荐

obsidian-enhancing-mindmap 设置项深度解析：画布、字体、层级与颜色调优攻略

什么是AMA Protocol：首个为AI智能体打造的隐私Layer 1区块链完整解析

Java 大厂面试实录：Spring Boot + Kafka + Redis + AI 检索增强生成，燕双非的三轮翻车现场

更多资讯

NC65主子表单据开发：UAP向导生成全流程与避坑指南

Nutanix超融合中文操作手册：集群运维决策树与实战避坑指南

8086循环程序设计：LOOPZ与REPZ CMPSB的取舍与调试

烽火交换机配置实战：带外登录、VLAN划分与IPTV组播排错

LLT低延迟趋势线：二阶滤波实现趋势信号实时化

华为OLT接入网开局实战：FTTH场景ONT配置与排障流程

今日更新

MATLAB缩进快捷键与批量格式化实战指南

用Poco实现Qt风格信号与槽的跨平台C++方案

ESXi裸机虚拟化安装指南：从硬件兼容到虚拟机部署

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？