はじめに

TUI（Terminal User Interface）アプリケーションを開発する際、vimやhtopのような既存のTUIライブラリを使えば簡単に実装できる。しかし、その裏でターミナルがどのように動作しているのか、なぜRaw Modeが必要なのか、ANSIエスケープシーケンスとは何なのかを理解していないと、高レベルのAPIが何をしているのかわからず、問題が起きたときに対処しづらい。

本記事では、TUI開発に必要なターミナルの仕様と実装について、以下の観点から解説する。

• 基本概念: ターミナル、シェル、TTY、termiosなどの用語の整理
• 動作原理: Line Disciplineによる入力処理、エスケープシーケンスによる画面制御
• 実装方法: Go言語での具体的な実装例（高レイヤーAPI/低レイヤーAPI）

ターミナルの仕様を理解することで、TUIライブラリの選定や独自実装の判断ができるようになり、デバッグ時にも問題の原因を特定しやすくなる。

前提知識：用語の整理

TUI開発を理解するには、まずターミナルに関連する用語を理解する必要がある。

コンソール（Console）

コンピューターの物理的な入出力デバイスを指す。元々はPC本体に直接接続されたキーボードとディスプレイを意味していた。OS的には「システムの主要な標準入出力端末」という扱いである。

端末（Terminal）

端末は、コンピューターへの入出力を行うデバイスまたはソフトウェアの総称である。歴史的には物理的な端末装置を指していたが、現在では主にソフトウェアで実装された仮想端末を指す。

端末エミュレータ（Terminal Emulator）

物理的な端末装置の機能をソフトウェアで再現したアプリケーションである。iTerm2、GNOME Terminal、Windows Terminal、xtermなどがこれにあたる。端末エミュレータは、キーボード入力をプログラムに渡し、出力を画面に描画する役割を担う。ANSIエスケープシーケンスを解釈して画面制御を行う。

主な端末エミュレータは以下の通り。

• macOS：Terminal.app、iTerm2
• Linux：GNOME Terminal、Konsole、xterm
• Windows：Windows Terminal、ConEmu

CLI（Command Line Interface）

コマンドをテキストで入力し、出力もテキストで受け取るインターフェイス形態である。GUI（グラフィカルUI）と対比される概念である。シェル、REPL、TUIなどがCLIの一種である。

コマンドライン（Command Line）

CLI上でユーザーが1行入力する実際の入力行を指す。ls -lやgit commit -m "msg"のような行である。シェルがこの文字列を構文解析（パース）して実行する。

シェル（Shell）

コマンドを受け取り、プログラムを実行するコマンド解釈プログラムである。bash、zsh、fish、PowerShellなどがある。ターミナル上で動作するが、ターミナルとは独立したプロセスである。

シェルの主な役割は以下の通り。

• コマンドの構文解析（トークン分割、リダイレクト処理など）
• 環境変数の管理
• プロセスの起動と制御（ジョブ制御。ジョブとはプロセスの集合のこと）
• スクリプト機能の提供

TUI（Text User Interface）

文字ベースのインターフェースで、画面全体を使ったインタラクティブなUIを提供する。通常のCLI（シェル）が1行ずつコマンドを実行するのに対し、TUIは画面全体を制御し、カーソル移動、色、枠線、メニュー、フォームなどを使ってリッチなユーザー体験を実現する。

TUIとCLIの違いは以下の通り。

POSIX（Portable Operating System Interface）

Unix系システムの互換性を保つための標準仕様である。IEEE（米国電気電子学会）によって策定され、システムコール、端末制御、ファイルI/O、スレッドなどのAPIを定義している。macOSやLinuxの多くのコマンドとシステムコールはPOSIX準拠である。

POSIX準拠のOSは以下の通り。

• Linux（Ubuntu、Debian、Red Hat等）
• macOS（Darwin）
• BSD系（FreeBSD、OpenBSD等）
• Solaris、AIX

最新仕様は以下の通り。

• POSIX.1-2024（IEEE Std 1003.1-2024）
• オンライン版

POSIX端末インターフェース（POSIX Terminal Interface）

POSIXで定義された端末の入出力制御に関する標準APIである。termios構造体とその関連関数（tcgetattr()、tcsetattr()など）によって、端末のモード設定、特殊文字の定義、ボーレート（シリアル通信におけるデータ転送速度）の設定などを行う。この標準化により、POSIX準拠のOS間で同じコードが動作する。

仕様ドキュメントは以下の通り。

• POSIX.1-2024 - General Terminal Interface

Unix端末インターフェース

Unix系OSにおける端末制御の伝統的な仕組みである。TTYドライバがカーネル内で端末デバイスを管理し、ラインディシプリンが入出力の処理（行編集、エコーバック、特殊文字処理など）を行う。POSIXはこのUnix端末インターフェースを標準化したものである。

TTY（TeleTYpewriter）

TTYは、Unix系OSにおける端末デバイスの総称である。元々は物理的なテレタイプライター（電動タイプライター）を接続するためのデバイスだったが、現在では仮想端末（PTY）を含む端末デバイス全般を指す。

TTY Line Discipline

ラインディシプリンは、Unix系OSのカーネル内でTTYドライバとユーザープロセスの間に位置し、端末の入出力処理を担当するソフトウェア層である。

ラインディシプリンの役割は以下の通り。

1. 行編集機能

   • Backspaceで文字削除
   • Ctrl+Uで行全体を削除
   • Ctrl+Wで単語を削除

2. エコーバック

   • 入力した文字を自動的に端末に送り返す
   • ユーザーが入力を確認できるようにする

3. 特殊文字処理

   • Ctrl+C → SIGINTシグナルを送信
   • Ctrl+Z → SIGTSTPシグナルを送信（プロセスを一時停止）
   • Ctrl+D → EOF（入力終了）

4. 文字変換

   • 改行コード変換（CR ↔ LF）
   • 大文字・小文字変換（古いシステム）

5. 入力バッファリング

   • カノニカルモード：Enterキーまで行単位でバッファリング
   • 非カノニカルモード：文字単位で即座に渡す

termios

POSIX標準の端末制御構造体である。以下の設定を管理する。

• 入力モード（c_iflag）：改行変換、フロー制御など
• 出力モード（c_oflag）：出力処理の設定
• 制御モード（c_cflag）：ボーレート、文字サイズなど
• ローカルモード（c_lflag）：エコー、カノニカルモード、シグナル生成など
• 特殊文字（c_cc）：Ctrl+C、Ctrl+Z、EOFなどの定義
• タイムアウト（VMIN、VTIME）：非カノニカルモードでの読み取り制御

TUI開発では、termiosを使ってRaw Mode（生入力モード）を実装する。

ioctl（Input/Output Control）

ioctlは、Unix系OSにおける汎用的なデバイス制御用のシステムコールである。ファイルディスクリプタを通じて、通常のread/write操作では行えない特殊な操作をデバイスドライバに指示する。

主な操作は以下の通り。

• termiosの取得と設定
• ウィンドウサイズの取得

tcgetattr / tcsetattr

POSIX標準で定義された端末制御の高レベルAPI関数である。ioctlシステムコールを直接使うより、ポータブルで読みやすいコードを書くことができる。

POSIX準拠のシステムでは、tcgetattr/tcsetattrを使うことが推奨される。プラットフォーム間の差異（定数名の違いなど）を気にせずにコードを書くことができる。

Go言語では標準ライブラリにtcgetattr/tcsetattrのラッパーがないため、以下の選択肢がある：

1. golang.org/x/termを使う（高レイヤー）

2. golang.org/x/sys/unixで直接ioctlを使う（低レイヤー）

golang.org/x/termパッケージは、内部でgolang.org/x/sys/unixのioctlを使用しており、プラットフォーム間の差異を吸収している。

PTY（Pseudo Terminal／擬似端末）

端末エミュレータが使用する仮想的な端末デバイスである。実際には2つのデバイスファイルがペアで動作する。

• master側：端末エミュレータが操作する側
• slave側：シェルやTUIアプリが接続される側

POSIX.1-2024（IEEE Std 1003.1-2024）では、master側を「manager」、slave側を「subsidiary」と呼んでいる。

シェルやTUIアプリはslave側を「本物の端末」として扱うため、物理端末と同じAPI（termios等）を使用できる。これにより、アプリケーション側は物理端末か仮想端末かを意識する必要がない。

デバイスファイルの例は以下の通り。

• Linux：/dev/pts/0、/dev/pts/1...
• macOS：/dev/ttys000、/dev/ttys001...

ANSIエスケープシーケンス（ANSI Escape Sequence）

端末の表示制御を行う特殊な文字列命令である。ESC文字（\x1bまたは\033）で始まる制御コードで、カーソル移動、色変更、画面クリアなどを指示する。

主な制御シーケンスは以下の通り。

• \x1b[31m：赤文字に変更
• \x1b[2J：画面クリア
• \x1b[H：カーソルを左上（1,1）に移動
• \x1b[10;20H：カーソルを10行20列に移動

TUI開発では、これらのシーケンスを直接出力して画面の描画、部分更新、色付けを実現する。ANSI X3.64として標準化され、VT100端末で実装されたことから広く普及した。

ターミナルの入出力の流れ

TUI開発で制御すべきターミナルの振る舞い

TUI（Text User Interface）アプリケーションは、シェルのようにコマンドを解釈するのではなく、端末（TTY）の入出力制御を直接扱う。

具体的には、termios API を用いて 端末のモード設定（例：カノニカルモードの無効化、エコーの無効化など） を変更し、ANSIエスケープシーケンスを利用して画面全体を描画・更新する。

通常のシェル環境では、端末はカノニカルモード (ICANON) に設定されており、ユーザーの入力は 行単位でバッファリングされ、Enterキーで確定後にプログラムへ渡される。

そのため、以下のように入力中の文字が自動的に画面にエコーされ、Enterキーでシェルに送信される。

一方、vim や less のような TUI アプリケーションは、端末を非カノニカルモードに切り替える。

これにより、キー入力は1文字単位で即座にアプリケーションに渡され、アプリケーション側で独自の入力処理・画面描画を行う。

TUI開発で必要な知識の全体像

TUIアプリを作るには、以下の技術要素を理解し制御する必要がある。

1. ターミナルモードの設定
2. 入力処理
3. 画面制御
4. ターミナルサイズの管理
5. バッファリング

以降のセクションでは、これらの技術要素について、仕様と実装方法を詳しく解説する。

ターミナルモードの設定

端末（TTY）の**ラインディシプリン（line discipline）**は、カーネル内で入力や出力の扱い方を制御するソフトウェア層である。主に3つの動作モード（Canonical／Non-Canonical／Raw）があり、termios構造体のフラグ設定によって切り替えることができる。

これらのモードはすべてカーネル内のTTY line disciplineによって実現されている。termiosやsttyコマンドは、このline disciplineの設定を変更するためのインターフェースである。

カノニカルモード（Canonical Mode / Cooked Mode）

通常の端末入力モードであり、端末のデフォルト設定である。行編集機能を持ち、入力は行単位でバッファリングされ、Enterキーで確定後にアプリケーションに渡される。

主な特徴は以下の通り。

• 行単位の入力バッファリング
• 行編集機能（Backspace、Ctrl+U、Ctrl+Wなど）
• エコーバック（入力文字の自動表示）
• 特殊文字処理（Ctrl+C、Ctrl+Z、Ctrl+Dなど）
• 改行コード変換（\r ↔ \n）

用途としては以下の通り。

• 通常のシェル操作（bash、zshなど）
• 対話型プログラム

Cooked Modeは、Canonical Modeの別名である。

非カノニカルモード（Non-Canonical Mode）

ICANONを無効にしたモードである。

行編集機能はカーネル内の TTY line discipline によって提供されるが、非カノニカルモードではその処理が無効化され、アプリケーション側で行う必要がある。

主な特徴は以下の通り。

• 文字単位で即時入力
• 行編集機能なし（Backspaceは単なる文字）
• エコーやシグナル処理は個別設定で残すことも可能

用途としては以下の通り。

• タイムアウト付き入力
• カスタムな入力制御を行うCLIツールなど

非カノニカルモード単体ではまだエコーやシグナル処理が残る可能性があるため、完全に制御したい場合はRawモードを用いる。

Rawモード（生入力モード）

端末の入出力変換と制御をほぼ完全に無効化したモードである。TUIアプリケーションなどで一般的に使用される。

主な特徴は以下の通り。

• 特殊文字や改行変換を含むあらゆる処理を無効化
• 入力はバイト列としてそのままアプリケーションへ渡される
• エコーなし
• シグナル生成なし（Ctrl+Cなども文字扱い）

用途としては以下の通り。

• TUIアプリ（vim、less、htopなど）
• ゲーム、独自画面制御ツール

sttyの-cookedはrawと同義であり、RawモードはCookedモードの対義語として扱われる。

モード比較表

入力処理

入力処理では「どんなキーが押されたか」を解析する。

矢印キー、ファンクションキー、マウスイベントなど、通常の文字以外の入力を処理する必要がある。これらは複数バイトのエスケープシーケンスとして送られてくる。

TUIアプリでは、これらのエスケープシーケンスを解析し、適切な操作を行う必要がある。

特殊キーのエスケープシーケンス

制御文字

画面制御（ANSI Escape Sequences）

画面制御では「どに何を表示するか」を指示する。

画面の任意の位置にカーソルを移動し、色を変更し、画面をクリアするなど、TUIの描画に必要な全ての操作を行う必要がある。

主要な制御シーケンスは以下の通り。

カーソル制御

画面クリア

色とスタイル

基本スタイル

前景色（テキスト色）

背景色

拡張色モード

代替スクリーンバッファ

ターミナルサイズの管理

TUIアプリはターミナルのサイズに合わせて描画する必要がある。また、ユーザーがウィンドウサイズを変更したときに再描画する必要がある。

ターミナルサイズは カーネルの TTY 構造体が保持する winsize 構造体 で管理され、ターミナルエミュレータが変更時に ioctl(TIOCSWINSZ) で通知し、カーネルが接続中のプロセスに SIGWINCH を送る。という流れになっている。

バッファリング

多数の制御シーケンスを送る際、1つずつ送ると遅くなる。バッファリングして一度にフラッシュすることで、画面のちらつきを防ぎ、パフォーマンスを向上させることができる。

以上が、TUI開発で必要なターミナル制御の5つの要素である。次のセクションでは、これらを実際にGo言語で実装する方法を見ていく。

GoでTUIの実装を学ぶ

ここでは、前セクションで説明した5つの技術要素を、Go言語で実際に実装する方法を解説する。

golang.org/x/termパッケージ（高レイヤーAPI）を使用した、約230行のシンプルな実装例を通じて、TUI開発の基礎を学ぶことができる。

ターミナルで必要な知識の全体像を学びやすいように、それぞれの技術要素を考慮した実装を行う。

実装する機能

1. ターミナルモードの設定

• term.MakeRaw()でRaw Modeに設定
• term.GetState()/term.Restore()で設定の保存と復元
• プログラム終了時に必ず元の状態に戻す

2. 入力処理

• 1バイトずつキー入力を読み取り
• エスケープシーケンスを解析して矢印キーを認識
• Ctrl+Cなどの制御文字を処理

3. 画面制御（ANSI Escape Sequences）

• カーソル移動（\033[{row};{col}H）
• 画面クリア（\033[2J\033[H）
• 色の設定（前景色）

4. ターミナルサイズの管理

• unix.IoctlGetWinsize()で現在のサイズを取得
• SIGWINCHシグナルでウィンドウサイズ変更を検知

5. バッファリング

• bufio.Writerで出力をバッファリング
• 複数の描画操作をバッファに蓄積
• Flush()で一度に画面に反映してちらつきを防止

実装

実行

操作方法は以下の通り。

• 矢印キー: カーソル（●）を移動
• q: 終了
• Ctrl+C: 終了
• ウィンドウサイズ変更: 自動的に検知（次のキー入力時に反映）

実装詳細

Terminal構造体

Terminal構造体はターミナルの状態を管理するための構造体である。

fdはファイルディスクリプタで、操作対象のファイルを指す。

Unix系OSでは、入出力（ファイル、ターミナル、ソケットなど）を整数の識別番号で管理する。

以下は標準的なファイルディスクリプタの番号と名前である。

標準入力のファイルディスクリプタは次のように取得できる。

fdを使ってターミナルの設定を操作することができる。

Raw Modeの設定

Raw Modeの設定は次のように行う。

Raw Modeの設定をする際はterm.Restore()を使って元の状態に復元しておかないと、プログラム終了時に元の状態に戻らない。

バッファリングによる最適化

バッファリングをする際はwriter.Flush()を使ってバッファをフラッシュする。

SIGWINCHによるサイズ変更検知

SIGWINCHはウィンドウサイズが変更された時に送信されるシグナルである。

SIGWINCHを受け取ったらterm.UpdateSize()を呼び出してウィンドサイズを更新する。

より低レイヤーな実装：golang.org/x/sys/unixを使う

golang.org/x/termパッケージは、内部でgolang.org/x/sys/unixを使用している。ここでは、termiosの各フラグを直接操作する低レイヤーな実装を見てみる。

この実装では、以下を学ぶことができる：

• termios構造体の各フラグ（Iflag、Oflag、Lflag、Cflag、Cc）の直接操作
• ioctlシステムコール（IoctlGetTermios/IoctlSetTermios）の使用
• tcgetattr/tcsetattr相当のAPI呼び出し

高レイヤー実装と比較することで、golang.org/x/termが内部で何をしているのかが理解できる。

この低レイヤー実装により、以下が理解できる：

• termiosの各フラグが具体的に何を制御しているか
• POSIX標準のtcgetattr/tcsetattrがGo言語でどう実装されるか
• ioctlシステムコールの実際の使い方

高レイヤー実装（golang.org/x/term）と低レイヤー実装（golang.org/x/sys/unix）の両方を理解することで、ターミナル制御の全体像が見えてくる。

まとめ

本記事では、TUI開発に必要なターミナル仕様について、用語の整理から実装まで解説した。

学んだこと

1. 用語と概念の整理

   • ターミナル、シェル、TTY、Line Discipline、termiosなどの関係性
   • POSIXとUnix端末インターフェースの位置づけ

2. TUI開発の5つの要素

   • ターミナルモードの設定（Canonical/Non-Canonical/Raw）
   • 入力処理（エスケープシーケンスの解析）
   • 画面制御（ANSIエスケープシーケンス）
   • ターミナルサイズの管理（SIGWINCH）
   • バッファリング（ちらつき防止）

3. 実装の理解

   • 高レイヤーAPI（golang.org/x/term）の使い方
   • 低レイヤーAPI（golang.org/x/sys/unix）によるtermios直接操作
   • tcgetattr/tcsetattrとioctlの関係

宣伝

ggcというgitのTUI・CLIツールを開発している。ターミナルについて学ぼうと思ったきっかけは、このアプリケーションの開発だった。

良かったらスターをつけてほしい。

参考

仕様・標準

• POSIX.1-2024 - General Terminal Interface
• termios(3) - Linux manual page
• TTY Line Discipline - Linux Kernel Documentation

Wikipedia

• Computer terminal
• Terminal emulator
• Text-based user interface
• POSIX terminal interface
• Seventh Edition Unix terminal interface
• Pseudoterminal
• ANSI escape code

チュートリアル・実装

• Serial Programming/termios - Wikibooks
• golang.org/x/term - Go Package Documentation
• ioctl(2) - Linux manual page