156 подписчиков

🦀 Ctrl+C в Rust: как не испортить жизнь пользователю и терминалу

31 июля31 июл

4 мин

Оглавление

📌 Решение №1: Проксирование вывода процессов через систему логирования
🧹 Решение №2: Обязательный сброс состояния терминала (с crossterm)
🔌 Решение №3: Грациозное завершение дочерних процессов

Разработка терминальных приложений всегда требует особой осторожности, ведь неаккуратное обращение с дочерними процессами легко превращает терминал пользователя в кошмар из хаотичных символов и висящих процессов. В новой статье от Николаса Джозефа из команды Fiveonefour подробно разбирается проблема, знакомая каждому Rust-разработчику: «Как корректно завершать дочерние процессы и очищать состояние терминала при нажатии Ctrl+C?».

Эта проблема кажется банальной ровно до того момента, как вы сталкиваетесь с ней вживую. Один неверный шаг — и вы получаете:

🧟‍♂️ «Зомби-процессы», продолжающие работу в фоне после закрытия приложения.
📺 Искажённый вывод терминала, когда вместо чистого приглашения вы видите странные символы.
🌀 Зависание терминала, когда невозможно вводить новые команды.

Давайте разберёмся, как избежать всего этого ужаса, опираясь на опыт автора, и добавим к этому собственное видение.

📌 Решение №1: Проксирование вывода процессов через систему логирования

Первая ошибка, которую допускают многие разработчики — прямое подключение stdout/stderr дочерних процессов к терминалу. Это приводит к конфликтам и "гонкам" (race conditions), когда процесс продолжает писать в терминал уже после его закрытия.

✅ Как правильно:

Используйте отдельные pipe-ы (через Stdio::piped()) для вывода.
Перехватывайте вывод и перенаправляйте его в систему логирования (например, log, tracing).
Не забывайте про graceful error handling: вывод процессов может неожиданно оборваться, и приложение должно быть к этому готово.

Пример реализации на Rust (используя Tokio):

let mut child = Command::new("docker")
.stdout(Stdio::piped())
.stderr(Stdio::piped())
.stdin(Stdio::null()) // Игнорируем stdin
.spawn()?;

// Проксируем stdout/stderr
let stdout_proxy = tokio::spawn(proxy_output(child.stdout.take().unwrap(), "stdout"));
let stderr_proxy = tokio::spawn(proxy_output(child.stderr.take().unwrap(), "stderr"));

🧹 Решение №2: Обязательный сброс состояния терминала (с crossterm)

Когда пользователь жмёт Ctrl+C, терминал часто остаётся в «сыром режиме» (raw mode), а курсор — спрятанным. В результате ввод команд ломается, а пользователь раздражается.

✅ Как правильно:

Всегда используйте библиотеку crossterm, которая обеспечивает кроссплатформенную очистку состояния терминала:

use crossterm::{
cursor::Show,
execute,
terminal::{disable_raw_mode, LeaveAlternateScreen},
};
fn cleanup_terminal() {
disable_raw_mode().ok();
execute!(stdout(), LeaveAlternateScreen, Show).ok();
}

Использование ok() вместо unwrap() гарантирует, что очистка всегда завершится, даже если терминал уже в правильном состоянии.

🔌 Решение №3: Грациозное завершение дочерних процессов

Ещё один источник кошмара — висящие процессы, не реагирующие на закрытие приложения. Автор предлагает использовать следующую иерархию сигналов:

🟡 SIGTERM: попытка аккуратного завершения (с возможностью сохранить данные).
🔴 SIGKILL: жёсткая остановка, если процесс не реагирует на SIGTERM.

И всегда устанавливайте таймаут!

async fn graceful_shutdown(mut child: Child) {
child.start_kill().ok(); // SIGTERM
tokio::select! {
_ = child.wait() => info!("Процесс завершился корректно"),
_ = tokio::time::sleep(Duration::from_secs(5)) => {
child.kill().await.ok(); // SIGKILL
warn!("Процесс завершён принудительно");
}
}
}

🎡 Решение №4: Синхронизация индикаторов (спиннеров)

Если ваше приложение показывает анимацию (например, спиннер загрузки), она легко может конфликтовать с выводом процессов, создавая путаницу в терминале:

Compiling Backend... ⠹
DEBUG: User authenticated.
⠸ # Вот это плохо!
user@machine:~$

✅ Как правильно:

Атомарно управляйте состоянием анимации через AtomicBool.
Резервируйте отдельные строки терминала.
Всегда завершайте анимацию до очистки.

Пример подхода:

impl Spinner {
fn stop(&self) {
self.stop_flag.store(true, Ordering::SeqCst);
if let Some(handle) = &self.handle {
handle.join().ok(); // Дожидаемся завершения
}
self.clear_line(); // Очищаем строку
}
}

💡 Личное мнение: почему это критично?

Разработка CLI-приложений в Rust сегодня — это особый тренд. Rust позволяет создавать быстрые и надёжные инструменты, но удобство конечного пользователя зависит именно от таких мелочей, как корректное завершение и очистка терминала.

Многие разработчики игнорируют эти аспекты, думая, что главное — функциональность. Однако именно проблемы с терминалом вызывают у пользователей наибольшее раздражение и приводят к негативным отзывам, а значит — к потере доверия к инструменту.

Поэтому правильно настроенное управление процессами — не просто техническая деталь, а обязательный элемент качественного продукта.

🚩 Итог: базовые принципы для комфортного CLI-приложения на Rust:

🔍 Всегда проксируйте вывод дочерних процессов.
♻️ Восстанавливайте терминал с помощью проверенных библиотек (crossterm).
🛑 Завершайте процессы поэтапно: сначала мягко (SIGTERM), затем жёстко (SIGKILL).
🎯 Синхронизируйте все анимации и взаимодействие с терминалом атомарно.

Следуя этим принципам, вы обеспечите пользователям чистый, стабильный и приятный опыт взаимодействия с вашим CLI-приложением на Rust.

🔗 Полезные ссылки: