學生按暫停、把字幕裡那行「打印」抄進編輯器，終端機回一句 NameError。你片裡明明打的是 print，口語也說「print」，自動字卻當成普通動詞譯走。程式教學廣東話字幕翻車，通常不是語氣不夠書面，而是螢幕上要複製的字被當成對白潤飾。
課堂講座字幕要鎖術語與公式，見課堂錄音字幕；那篇服務重溫定義。職場借詞如 meeting 的去留，見中英夾雜字幕。這篇只服務寫碼教學：講解可以轉書面，標識符、路徑、終端輸出與報錯必須跟編輯器裡的字元一致，大小寫也不能改。
讀完你應能分開三層文字——口播解釋、畫面代碼、字幕——並決定短片燒錄要避開哪一塊 IDE。
程式教學廣東話字幕：講解軌與代碼軌不要合成一句
寫碼片最少有兩條資訊通道。一條是你用廣東話解釋「這個迴圈在做什麼」；另一條是畫面裡的檔名、函式名、參數與紅字。通用轉寫喜歡把它們焊成通順中文，例如把「我們 call 這個 fetchUser」寫成「我們呼叫這個擷取使用者」。關聲跟課的人會以為函式真的叫那個中文名，複製後編譯失敗。
先分類，校對才不會跟教學片共用同一套「專有名詞優先」清單。
可轉書面的口播。 「咁呢度其實係話……」改成「這裡的意思是……」沒問題，觀眾要的是思路。填充詞去留見廣東話字幕填充詞。
不可改寫的標識符。 變數、函式、類別、套件、CLI 指令、旗標，一律按畫面或官方文件的拼法。fetchUser、git commit、--verbose、package.json 都不是借詞，是要被複製的字元。口語讀成「fetch user」時，字幕仍寫 fetchUser，不要加空格、不要改駝峰。
終端與報錯。 Traceback、ECONNREFUSED、zsh: command not found 不是對白。寫成「連線被拒絕」可以出現在下一句解釋，不可以取代那一行原文。學生搜錯誤碼時，靠的是英數字串，不是你的意譯。
鍵盤敲擊、風扇、通知音不要寫進對白。若要做聽障友善，用獨立標註，見廣東話無障礙字幕；不要把 [鍵盤] 塞進同一條代碼行。
現場打錯字是寫碼片獨有的第三層。你說「這裡應該是 userId」，畫面卻暫時停在 userID。字幕跟口播更正走，還是跟當下畫面走，必須二選一：若這幾秒是在示範除錯，字幕寫你實際打出來的錯字，下一條才寫更正後的識別名；若那是無意義的手誤、你會在時間軸上剪掉，字幕也不要留下那個錯拼。不要讓模型「幫忙」改成正確拼法，而畫面仍顯示錯字——學生會以為自己看錯。
先列「禁止翻譯」清單，再讓口語轉書面語開工
詞庫在寫碼片的用途，跟品牌 Vlog 相反。品牌片把中文正式名鎖死，避免近音；寫碼片要把不准變成漢字的字串鎖死，避免模型「幫忙」意譯。做法仍見字幕自定義詞庫，但條目類型不同。
課前準備一份清單，貼進詞庫或校對表：
- 本集會打出來的識別名： 函式、元件、資料庫表、環境變數。連
id與ID都分開寫，因為語言大小寫敏感。 - 指令與路徑：
cd、npm install、~/projects/demo。路徑裡的斜線、點、波浪號都要原樣；不要寫成「回到專案資料夾」冒充那一行字幕。 - 本集會讀出來的報錯原文： 從你預演過的失敗截圖複製，不要憑記憶拼。
- 套件與產品官方英文：
VS Code、Node.js、PostgreSQL。首次可用括號補中文慣用名，其後只留官方寫法。
清單完成後，才決定口播要不要轉書面。若先轉書面再校對代碼，模型會先把 print 吃掉，你稍後全文搜「打印」也找不到所有變體。風格開關見廣東話口語轉書面語；寫碼片應把該開關理解成只作用於解釋句。
YouTube 自動字幕在粵語加英文標識符時特別不穩：print 被切成殘缺拼音、float 變成「負」、檔名中的底線消失。公開課不要只靠 Studio 自動字當教材附件。上載校對稿的步驟見YouTube 廣東話字幕。
口語怎麼讀代碼，字幕怎麼寫：四條對照
現場為了好唸，幾乎人人會改讀法。字幕若跟著讀法走，學生抄下來的就不是合法代碼。
空格與標點。 你說「print 括號 hello」，畫面是 print("hello")。字幕寫後者。引號種類跟檔案一致：Python 常用直引號，不要隨書面語改成「」。
運算符。 「大於等於」在講解句可以漢字；對着那一行代碼時寫 >=。== 不要寫成「等於等於」，那會變成第三種語言。
數字與版本。 「Python 三點十二」字幕寫 Python 3.12，與安裝畫面同一字串。埠號 3000 不要寫成「三千」。版本、錯誤碼、HTTP 狀態屬代碼層，不是修辭。
中英夾雜的講解詞。 「我哋 debug 呢段」可保留 debug 或寫「除錯」，那是口語零件，規則可與頻道其他片一致。但「呢個 function 叫 debugSession」裡，只有前面的 function 能意譯，debugSession 不能。同一句拆成兩條字幕往往比塞在一行更安全：先出口語解釋，下一條單獨放要複製的字。
演算法課若把公式唸出來，字幕應用編輯器或講義上的符號，而不是漢字敘事。這點與一般課堂片相同，但寫碼片還要避免把 O(n) 寫成「噢恩」。
註解與說明字串又是另一條界線。你用廣東話解釋為什麼要寫這行註解，字幕可以書面；但檔案裡的 # TODO: handle timeout、JSX 可見文案、測試描述字串，屬於代碼，不要順手譯成「待辦：處理逾時」。學生若按字幕改檔，測試名稱與斷言會對不上 CI。UI 文案若本集主題是國際化，才在解釋句對照中文，並標明那是介面字，不是識別名。
燒錄位置：字不要蓋住行號、終端與紅波紋
長課在 YouTube 用軟字幕，學生可關可開，也不擋代碼。精華 Shorts、Reels、TikTok 多數要燒錄，而寫碼畫面的資訊密度比人臉 Vlog 高：左有行號與檔案樹，下有終端，右有問題面板，中間還有紅色波浪。
預設底部置中會蓋住你正在示範的 Error。較穩的做法：
- 直式裁切時，先決定代碼要留下哪一塊。 只放大正在改的十行，終端另開短鏡，不要指望一行字幕同時服務編輯器與終端。
- 字放在沒有標識符的色塊上。 常見是上方空白、或你加的半透明底，而不是疊在語法高亮上。行長規則見 Reels 字幕長度。
- 錯誤那幾秒，字幕讓路。 紅字出現時，對白字幕可暫停半拍，或只留「看終端這一行」而不重複把英文報錯燒在紅字上面。重複兩次同一串英文，小字會糊。
- 不要用分色當唯一線索。 「黃色是代碼、白色是口播」在轉載截圖與色弱觀眾身上失效。代碼句用反引號或獨立短行，比分色可靠。
軟字幕與燒錄的一般取捨見軟字幕與燒錄字幕。寫碼片多一個測試：把成片靜音、只看畫面——學生能否單靠字幕抄對函式名，同時仍看見你指標停在哪一行。
長課軟字幕與短片切片：同一母帶，兩種密度
完整堂課上架時，軟字幕可以較密：解釋句完整、代碼句獨立、報錯原文保留。語言標成頻道慣用的香港／繁中項。學生會用文字稿搜 EADDRINUSE，所以那串字必須出現在可下載、可搜尋的字幕裡，而不是只活在你口頭的「埠被佔用」。
短片相反。十五秒只教一個概念時，刪掉寒暄與自我更正，但不要為了短而把函式名縮寫成中文暱稱。封面可以寫「不要把 print 譯成打印」；畫面字幕仍要給出能跑的那一行。說明欄貼完整指令，與字幕同一份母帶，避免片內 npm i、欄裡卻寫 yarn。
長短共用一份文字母帶：標識符表、本集報錯原文、解釋句的書面稿。顯示層再分叉。轉寫時，能分軌就只丟人聲；敲鍵盤與系統提示音會把路徑裡的點聽成句號。嘈雜處理見廣東話語音轉文字遇噪音。模型若標低信心，先聽「讀代碼」的段落，不要從片頭開始改語氣。
出片前用三條問題即可：這行字幕貼進 REPL 或終端會不會原樣執行？報錯有沒有被意譯掉搜尋用的英數字？燒錄有沒有蓋住行號或紅波紋？三條都過，才調字級與描邊。時間軸仍要讀得完，見廣東話字幕時間軸。
CantoSub 可把函式名、套件名與指令寫進詞庫，並在中英夾雜設定裡保留那些英文標識符；口語轉書面只應用於解釋句。難段仍要對着畫面逐字核對。能力說明見 Model 2.0，配額見 收費方案，試用在 註冊頁。
常見問題
問：代碼已經在畫面裡，還要不要在字幕重複？
答：解釋句不必把整段函式抄進字幕。正在強調、要求學生跟着打的那一行要重複，而且必須與畫面逐字相同。只靠畫面、字幕寫意譯，關聲與小螢幕觀眾會抄錯。
問：報錯能不能只寫中文意思？
答：解釋可以中文，原文那一串要留在字幕或說明欄至少一處，與畫面一致。學生搜文件與論壇時用的是錯誤碼，不是你的轉述。
問：口語讀「for each」字幕要寫中文嗎？
答：講解句可寫「逐項」；對着 for...of 或 .forEach 時，寫畫面那個 API。兩種寫法可以相鄰兩條字幕，不要焊成一個新詞。
問：短片能不能把長指令折成口語？
答：可以口語說明目的，但指令本身不要意譯。太長就切鏡到終端全螢幕，或把完整指令放說明欄，並在字幕註明「指令見說明」。
問：這跟一般課堂字幕有何不同？
答：課堂片優先術語一致與公式可讀；寫碼片優先可複製字元與不要擋住 IDE。講義上的中文譯名可以出現在解釋句，不可以取代函式識別名。
本文由 CantoSub 團隊編寫／審閱；撰稿過程使用 AI 輔助，事實與產品說明以官網為準。