如何錄製讓人真的跟得上的終端機與命令列示範

終端機示範是開發者能製作的最實用影片之一，同時也是最難看下去的影片之一。極小的等寬文字、不斷捲動的輸出、還沒讀完就從畫面上方消失的指令——觀眾看兩分鐘就放棄了。

解法幾乎全在準備階段。清楚好讀的終端機錄影，是在按下錄製鍵之前就做好的，而不是事後搶救出來的。以下是完整流程。

終端機錄影為什麼難看

圖形介面的螢幕錄影有視覺錨點：按鈕、圖示、版面。終端機沒有。所有內容大小相同、顏色相同，而且捲動很快。問題永遠是同樣那幾個：

• 文字太小：在眼前看起來舒服的字級，用小視窗播放 1080p 影片時根本看不清
• 低對比佈景主題：近黑背景上的暗灰色在螢幕上很優雅，經過影片壓縮後就消失了
• 一閃而過的輸出：你還在講解指令，關鍵的那一行已經捲走了
• 看不見的輸入：觀眾看不到你的按鍵，快速敲出的旗標看起來像變魔術
• 空白時間：安裝、建置與測試會帶來三十秒什麼都沒發生的等待

這些問題每一個都能在五分鐘內解決。

錄製前先設定好終端機

把示範用的終端機當成與日常工作終端機不同的環境。多數終端機應用程式支援設定檔——建立一個名為「Recording」的設定檔，設定一次就好。

• 字級 18–24pt：大約是你平常用的兩倍。如果在螢幕上顯得誇張，那在影片裡多半剛剛好
• 高對比佈景主題：純色深底、明亮前景。完全不要使用透明與背景圖片——它們壓縮效果差，還增加視覺雜訊
• 調整視窗大小，而不是全螢幕：過大的全螢幕終端機會讓文字相對畫面變小。90–100 欄左右的視窗剛好填滿 16:9 畫面
• 必要時關掉連字：把 -> 和 != 變成箭頭符號的花俏字形，會讓想照抄指令的觀眾混淆
• 行距稍微加大：一點點留白就能讓密集的輸出好讀很多

整理你的 Shell

提示字元與歷史紀錄承載的資訊比你以為的多。錄製前：

• 簡化提示字元：包含 git 分支、Node 版本、時間戳記與兩行路徑的長提示字元既佔橫向空間又分散注意力。簡短的 ~/project $ 最理想
• 隱藏使用者名稱與主機名稱：在可能公開的影片裡，這些資訊能辨識出你和你的機器
• 清空捲動緩衝區與歷史紀錄：先前的指令可能洩漏客戶名稱、內部主機名稱或無關的工作
• 檢查環境變數：影片裡的 env 輸出洩漏的 API 金鑰比任何程式碼片段都多
• 使用拋棄式目錄：乾淨的專案資料夾能避免 ls 輸出混入無關檔案
• 關閉通知：終端機提示音與桌面彈出視窗都會打斷一次完整錄製

如果示範真的需要實際憑證，請改用假值。事後遮蔽遠比事先設定 API_KEY=demo-key-1234 費工。

規劃指令順序

錄製前把要敲的指令寫下來——寫進草稿檔，而不是靠記憶。一份依序列出你將輸入什麼的簡短腳本有三個作用：避免你在緊張時打錯字、讓示範維持一條主線，並直接成為旁白大綱。

接著不錄影地完整跑一次。這能找出意外：快取其實已經預熱、某個相依套件要先安裝、有個你忘記的確認提示。跑完後把目錄還原，讓正式錄製從相同狀態開始。

終端機工作的錄製設定

終端機內容多半是靜態文字，因此在某些方面很寬容，在另一些方面很嚴苛。

• 錄視窗而不是整個螢幕：視窗擷取讓畫面緊貼終端機，擋住桌面上的其他一切
• 30fps 就夠：文字不需要 60fps。較低的影格率也代表相同位元率下文字更銳利
• 以螢幕原生解析度錄製：事後放大文字正是模糊的來源
• 不加視訊鏡頭子母畫面，或保持很小：終端機示範的主角是輸出。大的子母畫面會遮住右下角，而新輸出正好出現在那裡

多數人做錯的地方：節奏

好的終端機示範的節奏，和你實際工作的節奏並不一樣。

1. 動手前先說出你要做什麼：「現在我要全域安裝這個 CLI」
2. 以穩定、清楚的速度輸入——比平常慢一些，但不要慢到不自然
3. 按下 Enter 前停一拍，讓完整指令有被看清、讀完的時間
4. 輸出出現時保持安靜，之後再講解
5. 指出重點，而不是把輸出整段唸出來

很長的指令可以分兩步可見地輸入——先敲基礎指令，再補上旗標——同時說明每個旗標的作用。這比四十個字元一次出現好跟太多了。

處理耗時很久的指令

沒人想看九十秒的 npm install。你有三個好選擇：

• 速度漸變：保持指令可見，但把等待段以 4–10 倍速播放，讓觀眾知道它發生過，卻不必陪著等
• 剪掉等待：從指令開始處剪到結果出現前。在提示字元那一行剪，剪接點就看不出來
• 事先預熱快取：錄製前先跑一次，正式錄製時自然幾秒就完成

不論選哪一種，都請口頭說明真實耗時——「這一步通常要兩分鐘左右」——這樣別人自己動手時才不會意外。

在編輯器裡讓輸出更好讀

編輯階段能把一段還可以的終端機錄影變成一段出色的錄影。

• 放大重要輸出：把鏡頭推向關鍵的那三行，遠比讓觀眾瞇著眼看滿螢幕日誌有效
• 為關鍵指令加文字疊層：把指令當字幕留在畫面上，觀眾聽旁白時也有東西可讀
• 標註錯誤訊息：當你刻意展示一次失敗時，請突顯解釋原因的那一行
• 加入章節：安裝、設定、第一次執行、疑難排解——終端機示範是邊看邊做的，觀眾常需要往回跳
• 移除靜音：自動靜音移除能收緊指令之間的空隙，又不動到你的講述

終端機與其他視窗混用

真實的示範很少只有終端機。你會執行指令、切到瀏覽器確認、再改設定檔。

• 錄製前決定版面：終端機與瀏覽器並排，或全螢幕切換——挑一種並堅持到底
• 切換視窗前先停一下：給觀眾半秒鐘意識到畫面變了，再繼續說話
• 維持字級一致：大字級終端機旁邊的小字級編輯器會變得無法閱讀
• 考慮區域擷取：如果兩個視窗的版面固定，擷取那塊區域能讓整段影片的構圖保持穩定

錄製前檢查清單

[ ] 已啟用錄製設定檔：大字級、高對比佈景、無透明
[ ] 提示字元已簡化，使用者名稱與主機名稱已隱藏
[ ] 捲動緩衝區與歷史紀錄已清空
[ ] 敏感資訊已替換為假值
[ ] 指令順序已寫下並預演一次
[ ] 工作目錄重設為乾淨狀態
[ ] 通知與終端機提示音已關閉
[ ] 已選擇視窗擷取、30fps、原生解析度
[ ] 已用十秒測試錄影檢查可讀性

最後一項最重要。錄十秒，用觀眾實際觀看的尺寸播放，問自己文字是否讀得舒服。若不舒服，先放大字型再試一次，然後再開始十二分鐘的正式錄製。

常見錯誤

• 在 4K 螢幕上全螢幕錄製：匯出影片裡的文字小到看不清
• 頻繁清畫面：觀眾會失去剛剛發生了什麼的脈絡
• 錄製途中調整終端機大小：文字重排，觀感突兀
• 逐字唸輸出：改成概括——「十二個測試全部通過」
• 讓游標在靜止畫面上一直閃：剪掉這些尾巴，它們會讓影片顯得卡住
• 預設觀眾認得你的別名：如果你敲 gs，請說明那是 git status

結論

終端機示範的成敗取決於可讀性。把字型調大、選高對比佈景、整理提示字元、預演流程，每個指令在 Enter 前留一拍。接著在編輯階段用縮放效果與速度漸變，把注意力牢牢鎖在關鍵輸出上。做到這些，你的命令列講解就不再是讓人硬撐著看完的影片，而是別人會打開終端機跟著一起做的影片。