開始前先準備

• 電腦接上電源，連上穩定的 Wi-Fi。第一次安裝要下載 1～2 GB，大約 15～40 分鐘。
• 知道這台 Mac 的開機密碼。過程中會要你輸入。輸入密碼時畫面不會出現任何字，連星號都沒有，打完直接按 Enter。
• 指令右邊有「複製」按鈕。按下去後，到終端機按 Cmd + V 貼上，再按 Enter。等它跑完、出現新的一行 % 再做下一件事。

1打開「終端機」

約 1 分鐘

1. 按 ⌘ Cmd + 空白鍵，畫面中間會出現搜尋框（Spotlight）。
2. 輸入「終端機」或 Terminal，按 Enter。
3. 最後一行長得像 名字@電腦名稱 ~ %。這個 % 代表「我在等你輸入指令」。

2貼上一行，全部裝好

第一次 15～40 分鐘，大部分時間在下載

在終端機貼上下面這一行，按 Enter：

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/olilllioli287/codenv_old/main/get.sh)"

1. 出現 Password: 時，輸入開機密碼，按 Enter。打字時畫面不會出現任何字，這是正常的。只要輸入這一次。
2. 之後什麼都不用按，等它一項一項裝完。畫面會顯示 [1/5] 到 [5/5] 做到哪裡。
3. 最後問「寫的程式要放在哪個資料夾」時，直接按 Enter 就是 ~/programming_language；想放別的地方就打資料夾路徑，例如 ~/Documents/C++作業。之後也可以用 codenv root 換。
4. 最後出現「完成」，iTerm 會自動打開。第一次問「確定要打開嗎？」就按「打開」。之後都用 iTerm，這個終端機視窗可以關掉。

codenv 安裝:缺什麼就裝什麼,已經有的會跳過
  這次要裝:Homebrew、編譯器、tmux、iTerm2,最後再裝 codenv 的設定
[1/5] 安裝 Homebrew(用一行指令安裝軟體的工具;沒有編譯器的話會順便裝)…
[2/5] 編譯器已經裝好了
[3/5] 安裝 tmux(把視窗切成好幾格的工具)…
[4/5] 安裝 iTerm2(codenv 的按鍵是照它設計的終端機)…
[5/5] 下載 codenv 最新版…
已安裝 ~/.vimrc
已安裝 ~/.tmux.conf
已安裝 ~/.codenv-ime(中文輸入法開著時,Ctrl+A 也能用)
已安裝 ~/.codenv-compat(Windows 寫的程式也能跑,例如 bits/stdc++.h、system("pause"))
已安裝 ~/.codenv.zsh
已在 ~/.zshrc 加上 source ~/.codenv.zsh
完成。

接下來改用 iTerm:已經幫你打開了(在「應用程式」資料夾裡)。

3讓 F9、F10 可以直接按

約 1 分鐘

MacBook 最上面那排鍵預設是調亮度、音量，直接按 F10 其實是「靜音」。選一種解法：

1. 每次一起按住 fn（左下角有地球圖示那顆），例如 fn + F10。
2. 改成預設就是 F 鍵：系統設定 → 鍵盤 → 鍵盤快速鍵… → 功能鍵 → 打開「將 F1、F2 等鍵作為標準功能鍵使用」。改了以後，調音量反而要按 fn。

4第一次使用：寫一支 Hello

約 5 分鐘

1. 如果 iTerm 是安裝之前就開著的，先按 Cmd + Q 完全關掉再打開；安裝完自動打開的就不用。
2. 輸入 codenv 按 Enter。第一次會先問畫面要幾格：輸入 2（左邊寫程式、右邊看結果，沒有用 AI 的話選這個）或 3（多一格放 AI 或終端機）。選完會記住。接著會介紹一次選用的 tmux-kit（中文選單、排列視窗），想裝就輸入 y，不要就直接按 Enter；再提醒一次 F9、F10 要怎麼按，並問要不要在桌面放說明 readme.pdf（直接按 Enter 就放）。這些都只出現一次。
3. 按 n Enter 新增資料夾，輸入名稱（例如 cpp）。清單出現 1) cpp 後，輸入 1 Enter。
4. 按 n Enter 新增檔案，輸入 hello.cpp（一定要有副檔名）。畫面會切好，vim 已經打開。
5. 按 i 開始打字（左下角出現 -- INSERT --），把下面這段打進去，打完按 Esc。練習的話建議自己打，不要貼。

#include <iostream>
using namespace std;

int main()
{
	cout << "Hello C++" << endl;
	return 0;
}

6. 按 F9 存檔並檢查，按 F10 編譯並執行。
7. 執行結果那格（兩格是右邊、三格是右下）出現 Hello C++ 就成功了。在那格按 Esc 會跳回 vim。

5選用設定

換畫面格數：輸入 codenv layout 重新選，或直接打 codenv layout 2、codenv layout 3。

三格時左邊自動開 AI：執行下面這行，用「文字編輯」打開設定檔，把 CODENV_AI='' 改成例如 CODENV_AI='claude'，存檔後重開 iTerm。

open -e ~/.codenv.zsh

一樣的配色：iTerm 選單 → Settings → Profiles → 左下角 Other Actions → Import JSON Profiles，在選檔視窗按 ⌘ Cmd + Shift + G，輸入 ~/.codenv-kit/iterm-profile.json。匯入後選中 codenv，再按 Other Actions → Set as Default。

手動安裝（一行裝不起來時）

第 2 步那一行會自動做下面這四步。它中途失敗、或你想自己一步一步來，就照順序做完這四步，結果一樣。一次只做一行，等它跑完、出現新的一行 % 再做下一行。

手動 1　安裝編譯器（Command Line Tools）

10～30 分鐘，大部分時間在下載

編譯器負責把你寫的 C++ 翻譯成電腦能執行的程式，也附帶 codenv 要用的工具。下一步的 Homebrew 沒有它就裝不起來，所以最先裝。

xcode-select --install

1. 跳出小視窗後按「安裝」，再按「同意」。
2. 等進度條跑完，出現「已安裝軟體」後按「完成」。

clang++ --version

Apple clang version 17.0.0 (clang-1700.0.13.5)

手動 2　安裝 Homebrew

5～15 分鐘

Homebrew 是 Mac 上「用一行指令安裝軟體」的工具，下一步要靠它。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1. 出現 Password: 時，輸入開機密碼，按 Enter。
2. 出現 Press RETURN/ENTER to continue 時，按 Enter。
3. 之後什麼都不要按，等到出現 ==> Installation successful!。

echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"

brew --version

Homebrew 4.x.x

手動 3　安裝 tmux 和 iTerm2

3～5 分鐘

tmux 負責把一個視窗切成兩格或三格。iTerm2 是比較好用的終端機 App，之後都用它取代內建的「終端機」。

brew install tmux

跑完、出現新的 % 後，再執行：

brew install --cask iterm2

tmux -V

tmux 3.5a

到「應用程式」資料夾找到 iTerm，點兩下打開。第一次打開如果問「確定要打開嗎？」，按「打開」。

手動 4　安裝 codenv

約 1 分鐘，要在 iTerm 裡做

在 iTerm 裡執行下面這一行。前面三步都裝好了，所以它只會從 GitHub 下載最新版的 codenv 並安裝：

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/olilllioli287/codenv_old/main/get.sh)"

已安裝 ~/.vimrc
已安裝 ~/.tmux.conf
已安裝 ~/.codenv-ime(中文輸入法開著時,Ctrl+A 也能用)
已安裝 ~/.codenv-compat(Windows 寫的程式也能跑,例如 bits/stdc++.h、system("pause"))
已安裝 ~/.codenv.zsh
已在 ~/.zshrc 加上 source ~/.codenv.zsh

完成。關掉 iTerm(Cmd+Q)重開,輸入 codenv 就能使用

安裝

使用

vim

tmux 與輸入法

1codenv 指令

程式預設放在 ~/programming_language 底下（安裝時可以選別的資料夾，之後用 codenv root 換），每個資料夾是一個科目或一次作業。新檔名一定要有副檔名（.cpp 或 .py）。

2F9 與 F10

• F9：存檔，並檢查有沒有打錯。結果顯示在執行結果那格，最後一行用顏色標出 ✓ code is ok、⚠ code has warnings 或 ✗ code is error。游標留在 vim。之後一改程式，這一行會變成 ● 未儲存，存檔後變成 ✓ 已存檔，看一眼就知道有沒有存。剛用 vim 打開程式時，這一行一開始就是 ✓ 已存檔；按 Ctrl+S 存檔時它會反白閃一下，本來就存好了也會閃。
• F10：存檔、編譯、執行。有錯就跟 F9 一樣只顯示錯誤；沒錯就在執行結果那格執行，游標跳過去，程式要輸入資料就在那裡打。按 Esc 跳回 vim。
• C++ 用 g++ -std=c++17 -Wall 編譯，執行檔放在旁邊的 bin 資料夾。Python 用 python3 執行。

怎麼看錯誤訊息

第 6 行: error: expected ';' in 'for' statement specifier
    6 |         for(r=1,r=r+1,r<10)
      |                           ^

第一行：錯在第幾行、種類（error 是錯誤，不改就不能執行；warning 是提醒，可以執行但可能有問題）、說明。第二行把那行程式抄出來，^ 指出編譯器發現問題的位置。真正打錯的地方常常在 ^ 前面一點。同一行在 vim 裡也會畫上紅色底線。

錯誤很多時，先修第一個 error 再按一次 F9：後面的訊息常常是第一個錯連帶造成的。有 error 時 warning 先不顯示，最後會用一行灰字說還有幾個。

3程式當掉時的訊息

程式有執行、但不是正常結束時，最後會出現紅字 ✗ code is error 和原因：

4vim 基本操作

vim 有兩種主要模式：一般模式打的字是指令，輸入模式打的字才會進到檔案。左下角出現 -- INSERT -- 代表在輸入模式。

更多按鍵（移動、刪除複製、搜尋取代、卡住時怎麼辦）在 vim 教學。

5編輯快捷鍵

這些按鍵跟 Windows 上的 C++ 編輯器（Dev-C++、Visual Studio）一樣，打字時也能用。

6tmux 入門

tmux 負責把一個終端機視窗切成好幾格，而且讓程式在背景繼續跑。先認識三個名詞：

最下面那條狀態列

藍底是工作階段的名字；後面的 [1] zsh、[2] cpp 是分頁，數字是編號，按 Ctrl+A 再按數字就能切過去。

暫時離開，等一下再回來

按 Ctrl+A → d 會離開 tmux，回到一般的終端機，但裡面的程式、打到一半的檔案都還在背景。要回去就輸入：

tmux attach

往上看之前的輸出

在那一格用滑鼠滾輪往上捲就好。也可以按 Ctrl+A → [ 進入捲動模式，用方向鍵或 PageUp 移動，按 q 離開。每一格最多記得最近 10000 行。

7tmux 快捷鍵

tmux 的快捷鍵都是兩段式：先按 Ctrl+A，兩個都放開，再按下一個鍵。按錯了按 Esc 取消。

格子

分頁

其他

8Ctrl+A 兩下的選單（tmux-kit）

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/olilllioli287/tmux-kit/main/get.sh)"

連按兩次 Ctrl+A，畫面中間會跳出這個選單。不用記快捷鍵，也不受中文輸入法影響：

• 用 ↑ ↓ 移動反白的那一行，按 Enter 執行；也可以直接用滑鼠點。滑鼠移到選單外面，選單也會留著，點選單外面才會關掉。
• 按 Esc 關掉選單，什麼都不做。
• 選「關掉這格」會再問一次，按 Enter 確定。
• 選「幫這個分頁取名」，最下面會出現輸入框，直接打新名字（中文也可以）按 Enter 就好；什麼都沒打就按 Enter，或按 Esc，名字都不會變。改的是最下面 [1] zsh 這種分頁名稱。
• 選「幫這個工作階段取名」用法一樣，改的是左下角「Session 0」那塊的名字（工作階段名稱）。
• 「列出所有分頁,切換過去」會列出每個工作階段和底下的分頁，用 ↑ ↓ 選、Enter 切過去，Esc 離開。這個畫面是 tmux 內建的，所以是英文。
• 「往左移 / 往右移」跟旁邊的分頁交換位置，畫面會跟著移過去；「重新編號」把空號補起來，例如 1 2 4 變成 1 2 3。
• 「用滑鼠排列格子」打開排列視窗，跟按 Cmd+Ctrl+A 一樣。
• 「模塊化排列(搬動格子、取名)…」會再打開一個選單：
  • 「把這格搬到別的分頁」：接著選要搬去哪個分頁，這格會排在那個分頁的右邊。
  • 「把別的格子搬進這個分頁」：接著選要搬哪一格。在分頁那一行按 → 可以展開，看到裡面的每一格；直接選分頁的話，搬的是那個分頁目前選到的那格。
  • 「把這格拆出去,變成新的分頁」：只有一格的分頁不用拆。
  • 四種排法：左右並排、上下堆疊、左邊一大格右邊幾小格、排成方格。排完還可以用滑鼠拖格子的邊界調大小。
  • 「幫這格取名」：名字會顯示在那格上方，搬到別的分頁也會跟著；「拿掉這格的名字」後，分頁裡沒有名字了，名字列就收起來。
• 「關掉整個工作階段」會關掉目前這個工作階段裡所有分頁的程式（包括 Claude Code），救不回來，所以會再問一次，按 Enter 確定。還有別的工作階段的話會直接切過去。

9用滑鼠排列格子（tmux-kit）

格子、分頁多起來以後，用快捷鍵搬來搬去不好記。排列視窗把每個工作階段、分頁和格子畫成小縮圖，直接用滑鼠拖。

打開和收起

• 在 iTerm 裡按 Cmd+Ctrl+A 打開，再按一次收起來。在別的 App 按不會有反應，不會搶走那個 App 自己的快捷鍵。
• 切到別的 App 時，排列視窗會自動收起來；切回 iTerm 再按一次就出現。
• 也可以從 Ctrl+A 兩下的選單選「用滑鼠排列格子(開視窗,Cmd+Ctrl+A)」。
• 按 Esc、Cmd+W 或左上角的紅色按鈕都是收起來，下次按 Cmd+Ctrl+A 馬上出現。
• 視窗浮在 iTerm 上面，第一下就能直接拖，不用先點一下視窗。
• iTerm 開成全螢幕也一樣，視窗會疊在現在的畫面上，不會跳到別的桌面。

可以做的事

視窗裡的 session、window、pane 就是 tmux 的工作階段、分頁、格子（見 tmux 入門）。分頁名字旁邊的橘色小點代表那裡有新的動靜，例如 Claude 回覆完了。

zsh ~/.tmux-kit/uninstall.sh

10中文輸入法

注音、威注音這類輸入法開著時，你按的字母會先被拿去組字。codenv 的處理方式：

• Ctrl+A 指令：按下 Ctrl+A 的瞬間自動切成英文，指令做完再切回原本的輸入法。按完 Ctrl+A 稍等一下再按下一個鍵比較保險。
• 選單：裝了 tmux-kit 的話，Ctrl+A 連按兩次叫出的選單只用方向鍵、Enter、Esc，完全不受輸入法影響。
• vim 的快捷鍵：Ctrl+S、Ctrl+Z、F9、F10 這些組合鍵和功能鍵，輸入法不會攔，照常能用。

11滑鼠

• 點一下切換到那一格；滾輪上下捲動；拖曳格子之間的分隔線調整大小。
• 想把格子搬到別的分頁、交換分頁位置，可以裝 tmux-kit，按 Cmd+Ctrl+A 用排列視窗拖曳。
• 在 vim 裡點一下移動游標，拖曳或雙擊選取文字，再按 Ctrl+C 複製。
• 在 vim 以外的格子（例如執行結果）想反白複製文字，要按住 Option 再拖曳，然後按 ⌘ Cmd+C。

12改成自己的習慣

codenv 是 MIT 授權，可以照自己的習慣改。最簡單的方法：把自己的設定寫在 .local 檔。codenv 更新時會整個換掉 ~/.vimrc 和 ~/.tmux.conf，但不會動到 .local 檔，你的設定會一直保留。

例如想讓 vim 的行號顯示成「離游標幾行」，用下面這行打開（沒有這個檔會自動建立）：

touch ~/.vimrc.local && open -e ~/.vimrc.local

在裡面寫 set relativenumber，存檔後重開 vim。寫在 .local 的設定會蓋過 codenv 的同一項設定。

想改得更多（例如改 F10 的行為），可以在 GitHub 上 fork 一份到自己的帳號來改，做法見技術文書的「原始碼與授權」。

13用 AI 輔助學習

用 AI 問程式問題時，先讓它知道「你是剛開始學 C++ 的新生、希望一步一步來」，它就不會一次丟一整支程式或一堆看不懂的名詞。下面這段是給 AI 的「記憶」，貼一次之後，每次對話它都會記得。

Gemini

1. 打開 Gemini 的「將個人化記憶匯入 Gemini」頁面。
2. 第 1 格的提示詞不用理它。
3. 按下面方塊右邊的「複製」，貼到第 2 格「把你的資訊貼到這裡…」。
4. 按「新增個人化記憶」。

使用者是大學一年級新生，正在修「計算機程式（一）」，課程教 C++，課本是 Savitch 的《Absolute C++》。使用者沒有任何程式基礎，第一次學寫程式，很多基本概念和名詞都還不懂。

課程內容依序是：第 1 章 C++ 基礎（cout、cin、變數、整數除法、%、型別轉換、++ 和 --、小數位數），第 2 章流程控制（if、switch、while、for、巢狀迴圈），第 3 章陣列（加總、最大最小值、搜尋、排序、矩陣）。成績有 60% 是三次上機考，要在電腦上自己把程式打出來、編譯、執行，考試用的編輯器是 Dev-C++；另外筆試 30%、作業 10%。

教使用者時的方式：
- 一律用繁體中文（台灣用語）回答。
- 一次只教一個概念或一個步驟，確認使用者懂了、做完了，再進下一步。不要一次丟出很多內容或一整支完整程式。
- 先用白話講，再補正式說法。專有名詞第一次出現時，用一句話解釋它是什麼。
- 解釋「為什麼」，不要只給答案。
- 使用者要練習上機考，所以寫作業或練習題時，先給提示和思考方向，讓使用者自己打程式；使用者卡住或主動要求時，再給更完整的程式碼。
- 每次出現使用者沒看過的新指令（例如 cout、for、rand），附上一個很短的範例和它的執行結果。
- 使用者貼出錯誤訊息或程式時，先說明那段訊息是什麼意思、錯在第幾行，再說下一步怎麼改，一次只改一個地方。
- 提醒使用者：上機考是電腦自動比對輸出，多一個或少一個空白都算錯，輸出格式要跟題目一模一樣。
- 語氣溫和、冷靜，像有耐心的學長姐。不要過度稱讚，也不要講空泛的鼓勵；使用者的理解有錯時，直接但友善地指出來。
- 使用者看起來很累或說看不懂時，把步驟拆得更小、講得更短。

內容用「使用者」而不是「我、你」，是因為 Gemini 的匯入頁面要求用第三人稱。如果考試用的不是 Dev-C++，把那一句改成自己實際用的編輯器。

讓 AI 讀懂 codenv：想問 AI 關於 codenv 的問題時，把這個網址給它：https://raw.githubusercontent.com/olilllioli287/codenv_old/main/docs/guide.md。這是整個網站的純文字版，AI 比較讀得懂。AI 連不上網的話，打開這個網址按 ⌘S 存成檔案，再上傳給它。

ChatGPT、Claude 也能用：貼到 ChatGPT 的「自訂指令」或 Claude 專案的「指示」欄位，效果一樣。

還有一點：上機考不能用 AI，最後還是要自己會打。讓 AI 給提示、自己動手寫，比直接拿答案有用得多。

14換回舊版設定

每次安裝或更新，有變動的設定檔都會先備份成「檔名.bak-日期時間」。先列出備份檔：

ls ~/.vimrc.bak-* ~/.tmux.conf.bak-*

再把想要的那份複製回來（把 日期時間 換成上面列出來的那串數字），然後重開 vim：

cp ~/.vimrc.bak-日期時間 ~/.vimrc

15解除安裝

在 iTerm（或內建的「終端機」）執行下面這一行：

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/olilllioli287/codenv_old/main/uninstall.sh)"

• codenv 的檔案（~/.codenv.zsh、~/.codenv-ime、~/.codenv-compat、~/.codenv-kit，以及 codenv 裝的 ~/.vimrc、~/.tmux.conf）會移到家目錄的 codenv-removed-日期時間 資料夾，不會直接刪掉。
• ~/.zshrc 裡載入 codenv 的那行會拿掉（原本的檔案也備份在同一個資料夾）。
• 裝 codenv 之前原本就有 ~/.vimrc、~/.tmux.conf 的話，會放回當初的那份備份。
• 不會動：你寫的程式（整個程式資料夾留著）、Homebrew、編譯器、tmux、iTerm2（別的程式可能也在用）。
• 裝了 tmux-kit 的話不會一起拿掉，要另外執行 zsh ~/.tmux-kit/uninstall.sh。

做完關掉 iTerm 再打開，codenv 指令就不見了。想恢復，再執行一次安裝的那一行就好；確定不要了，可以自己刪掉 codenv-removed-日期時間 資料夾。

1先認識 vim

vim 是在終端機裡用的文字編輯器，幾乎每台 Mac 和 Linux 都有。它的特色是不用滑鼠，靠鍵盤上的字母就能移動、刪除、複製，所以要先分清楚「現在打的字是指令還是內容」，也就是下一節的模式。

codenv 在 vim 上加了 Windows 編輯器的習慣（見使用手冊的編輯快捷鍵），完全不學 vim 指令也能寫作業。這頁的按鍵是 vim 原本就有的，兩種可以混著用。

  1 #include <iostream>
  2 using namespace std;
  3 
  4 int main() {
  5     cout << "Hello" << endl;
  6 }
-- INSERT --

• 左邊的數字是行號。F9 的錯誤訊息說「第 5 行」，就看這裡。
• 最下面一行顯示現在的模式（例如 -- INSERT --），按 : 打的指令也會出現在這裡。
• 按 F9 後，有錯的地方畫紅色底線，警告畫黃色底線。
• 有沒有存檔，看執行結果那格的 ✓ 已存檔 / ● 未儲存。

2模式

同一個按鍵在不同模式做的事不一樣。例如 x 在輸入模式會打出 x，在一般模式是刪掉一個字。

3開檔、存檔、離開

這些都在一般模式打，打完按 Enter。

4移動游標

方向鍵和滑鼠在每個模式都能用。下面這些在一般模式用，比按很多次方向鍵快。

前面加數字可以重複：5j 往下 5 行，3w 往後 3 個字。

5刪除、複製、貼上

都在一般模式用。

數字一樣能用：3dd 刪三行，5yy 複製五行。

6搜尋與取代

7寫程式好用的功能

8卡住了怎麼辦

9用 vimtutor 練習

vim 內建一份互動練習 vimtutor，有中文版。照著做大約 30 分鐘，練習用的是複製出來的檔案，不會動到你的程式。在沒有在用的一格（例如三格模式左邊那格，或按 Ctrl+A → c 開新分頁）輸入：

LANG=zh_TW.UTF-8 vimtutor

前面的 LANG=zh_TW.UTF-8 是要它用中文版；只打 vimtutor 的話會照 Mac 的語言設定，可能出現英文版。練習時用的是原版 vim，codenv 加的 Ctrl+S、Ctrl+Z 這些在裡面不能用，照教學用 :w、u 就好。練習完輸入 :q! 離開。

1安裝了哪些檔案

2一行安裝的流程

1. get.sh 先檢查 Homebrew、編譯器、tmux、iTerm2，缺的照順序裝：要裝 Homebrew 或編譯器時先 sudo -v 問一次密碼，背景每 50 秒延長一次；Homebrew 用官方安裝程式加 NONINTERACTIVE=1（它會順便用 softwareupdate 裝編譯器），裝完把 brew shellenv 寫進 ~/.zprofile；tmux 用 brew install、iTerm2 用 brew install --cask。測試時可以設 CODENV_DRYRUN=1（只印出要做的事）和 CODENV_PRETEND_MISSING（假裝哪些沒裝）。
2. 接著從 GitHub 下載 main 分支的壓縮檔，解到 ~/.codenv-kit（舊的會先移除），再執行裡面的 install.sh。在內建的「終端機」執行的話，最後會打開 iTerm。
3. install.sh 比對 vimrc、tmux.conf：內容一樣就跳過，不一樣就先備份再覆蓋。
4. 用 swiftc 編譯 codenv-ime.swift；原始碼沒變就不重編，沒有編譯器就跳過（其他功能不受影響）。
5. 舊版裝過排列視窗（~/.codenv-board 和它的 LaunchAgent）的話，用 launchctl bootout 關掉，檔案移到 ~/codenv-removed；排列視窗和中文選單已經搬到 tmux-kit。
6. 把 compat/ 複製成 ~/.codenv-compat（內容一樣就跳過；不一樣就整個資料夾換成新版，新版刪掉的檔案不會留下來）。
7. 安裝新的 codenv.zsh 前，先讀出舊檔裡的 CODENV_ROOT、CODENV_AI、CODENV_LAYOUT、CODENV_TMUXKIT，裝好後填回去。
8. tmux 正在執行的話，直接 source-file 載入新設定。

3F9 / F10 背後做了什麼

• 在檔案所在的資料夾執行 g++ -std=c++17 -Wall（F9 加 -fsyntax-only 只檢查；F10 輸出到 bin/檔名）。Python 用 py_compile 檢查。
• 編譯器訊息只留下跟自己檔案有關的部分，系統標頭檔的 note 全部拿掉；每則訊息開頭的「檔名:行:字:」改寫成「第 N 行:」，並用 matchaddpos 在 vim 裡畫底線。
• 執行結果那格是 tmux 右下（或右邊）的 pane，用 respawn-pane 重開並執行程式，跑完回到 shell。pane 被關掉時會依 @codenv_layout 在右邊或下面重開。
• 執行指令前先 trap : INT：Ctrl+C 只停掉程式，外層 shell 留著，那格才不會跟著消失。
• F10 編譯時加 -fsanitize=integer-divide-by-zero,bounds -fno-sanitize-recover=all，執行時設 UBSAN_OPTIONS=exitcode=86:abort_on_error=0：arm64 的整數除以 0 不會產生 SIGFPE，沒有這個檢查只會得到 0。不開 signed-integer-overflow，溢位的行為跟 Windows 一樣。
• 程式結束後檢查 exit code，130 以外的非 0 值用紅字標示，並說明常見原因。
• Windows 相容：編譯時加 -I ~/.codenv-compat/include（提供 bits/stdc++.h，以及用 termios 暫時切成不等 Enter、不回顯的 conio.h；getch() 直接 read() 鍵盤，不經過 cin 的緩衝區，跟 Windows 一樣讀不到前面留下的 Enter）和 -include codenv-unbuffered.h（程式開始前 setvbuf(stdout, nullptr, _IONBF, 0)，輸出不等換行就顯示）；執行時把 ~/.codenv-compat/bin 放進 PATH，system("pause")、system("cls") 才找得到指令。Python 加 PYTHONUNBUFFERED=1。用到 windows.h 時在錯誤訊息下面加一行中文說明。
• Python：py_compile 的縮排錯誤格式是 Sorry: IndentationError: … (檔名, line N)，跟一般的 File "…", line N 不同，兩種都抓行號；常見的幾種錯誤加一行中文說明。
• 有 error 時，warning 和跟在它後面的 note 不顯示，最後加一行灰字說隱藏了幾個；只有 warning 時照常全部顯示。
• 存檔狀態：BufWritePost、TextChanged、TextChangedI 判斷檔案現在是已存檔、未儲存，還是剛檢查過（記在 b:code_state，狀態沒變就不做事）。改變時用 tmux capture-pane 找執行結果那格畫面上的狀態行，再直接寫進那格的終端機（pane_tty）：ESC 7 記住游標、移到那一行清掉重寫、ESC 8 放回游標，所以不會打斷那格的 shell。找不到狀態行就不改。剛打開 .cpp / .py、那格又只有提示字元（是 shell、沒有子程序、畫面上每行都一樣）時，用 tmux respawn-pane 重開那格，先印出狀態再進 shell。存檔時寫一次加上反白（ESC [7m）的同一行，0.25 秒後再寫回一般的樣子。
• 連結錯誤：訊息裡有 Undefined symbols 時，從 "名稱", referenced from 抓出找不到的函式，_main 另外提示 main 打錯字。

4輸入法自動切換（codenv-ime）

輸入法會在按鍵送進終端機之前就把字母拿去組字，tmux 收不到。Ctrl 組合鍵不會被攔，所以在按下 Ctrl+A 時切換最可靠：

1. tmux 的 prefix 設成 None，改用 bind -n C-a 自己處理：先在背景執行 ~/.codenv-ime tmux-prefix，再 switch-client -T prefix。
2. codenv-ime 用 macOS 的 Text Input Sources API（TISSelectInputSource）切到 ABC 鍵盤；本來就是英文時什麼都不做。
3. 之後每隔一小段時間問 tmux #{client_prefix}，變回 0（指令做完）就切回原本的輸入法；如果這段時間你自己換過輸入法，就不切。
4. 從按下 Ctrl+A 到切成英文大約 0.1 秒。沒有 ~/.codenv-ime 時，Ctrl+A 照常運作。

5排列視窗（已搬到 tmux-kit）

排列視窗（原本的 codenv-board）、中文選單和格子取名，2026-10-15 起搬到 tmux-kit，原始碼和技術說明都在那邊。codenv 的 tmux.conf 最後有一行 source-file -q ~/.tmux-kit/tmux-kit.conf：裝了 tmux-kit 就載入它，沒裝就什麼都不做；沒裝時 Ctrl+A 兩下綁到一行提示。第一次輸入 codenv 會介紹一次 tmux-kit，看過就在 ~/.codenv.zsh 記下 CODENV_TMUXKIT=shown。

6tmux 改了哪些設定

codenv 沒有用 TPM 之類的第三方外掛，全部的改動都寫在 ~/.tmux.conf 這一個檔案裡。跟剛裝好的 tmux 比，差別如下：

7vim 設定重點

• Windows 式選取：selectmode=mouse,key、keymodel=startsel,stopsel、selection=exclusive。
• 剪貼簿：Ctrl+C / X / V 對應到 "* 暫存器（macOS 的 vim 有 +clipboard）。沒有選取時 Ctrl+X 設成 <Nop>，蓋掉 vim 原本「數字減 1」和插入模式的 ^X 補全。
• 自動補括號用 <C-g>U<Left> 移動游標，不會打斷復原的步驟；貼上時 bracketed paste 會略過這些對應，所以貼上的程式碼不會被重複補。
• 自動縮排：filetype indent on，Python 用 vim 內建的 python#GetIndent；C++ 另外設 cindent。
• Esc 不等待：ttimeout ttimeoutlen=50（原本 Esc 要等 timeoutlen 的 1 秒，確定後面沒有接方向鍵之類的按鍵碼）。
• Big5：fileencodings=ucs-bom,utf-8,cp950,latin1，讀進來是 cp950 的檔案在 BufReadPost 改成 fileencoding=utf-8，存檔時就轉好。
• 暫存檔（swap）：SwapExists 用 swapinfo() 和 kill -0 判斷另一個 vim 還在不在；在的話用它的 tty 對照 tmux list-panes -a 找出分頁編號。
• { 加 Enter 補 } 前，用 searchpair 找配對的 }，而且要縮排相同才算「已經有了」，避免誤配到外層的 }。

8原始碼與授權

原始碼在 github.com/olilllioli287/codenv_old，採用 MIT 授權：可以自由使用、修改、分享，只要保留原作者的著作權聲明（LICENSE 檔）。

fork 一份改成自己的版本

1. 在 GitHub 的 codenv 頁面右上角按 Fork，複製一份到自己的帳號。
2. 改自己那份裡的檔案，並把 get.sh 開頭的 repo=olilllioli287/codenv_old 改成自己的「帳號/repo 名稱」。
3. 之後安裝、更新都改用自己那份的網址：zsh -c "$(curl -fsSL https://raw.githubusercontent.com/你的帳號/codenv/main/get.sh)"

只是想調幾個小地方的話，不用 fork，寫在 .local 檔就好，見使用手冊的「改成自己的習慣」。