Vibe Coder
電腦不是魔法：Vibe Coder 必懂的檔案系統與終端機基礎
電腦不是魔法：Vibe Coder 必懂的檔案系統與終端機基礎
很多人開始學 Vibe Coding 時，都有一個隱藏的假設：「反正 AI 會處理，我不需要懂底層。」這個假設在前幾步是對的，但遇到第一個錯誤時就會卡死。電腦是一台嚴格按照規則運作的機器：路徑少一個斜線、副檔名打錯一個字母、終端機在錯的資料夾裡，都會讓一切停擺。AI 能幫你寫程式，但它不能替你把檔案放到對的地方。
你將學到什麼
檔案系統怎麼組織
從根目錄、資料夾到副檔名，看懂電腦怎麼存放東西。
路徑是什麼意思
分清楚絕對路徑與相對路徑，看懂 . 、 .. 、 ~ 的意思。
終端機四個保命指令
pwd、ls、cd、mkdir，學會就能應付九成場景。
卡關時怎麼辦
常見錯誤訊息速查表，加上把問題描述清楚給 AI 聽的方法。
為什麼 Vibe Coder 需要懂電腦基礎
| 原因 | 說明 |
|---|---|
| AI 不知道你的電腦長什麼樣 | AI 產出的指令預設某個環境，你的環境不同就會出錯，你必須能判斷差在哪。 |
| 找不到檔案是最常見的卡關 | 路徑錯誤、副檔名看不見、檔案在哪個資料夾，這些問題每天都在發生。 |
| 終端機是 AI 的溝通介面 | 幾乎所有 AI 給你的安裝指令都要在終端機跑，看不懂就寸步難行。 |
| 懂基礎才能描述問題 | 跟 AI 說「不能用」沒有用，說「在這個路徑執行這個指令出現這個錯誤」才有用。 |
檔案系統：資料夾、檔案、副檔名
電腦裡的所有東西，都存在一個樹狀結構裡。最頂層是根目錄，往下是一層一層的資料夾，最底層是檔案。
| 概念 | 說明 | 例子 |
|---|---|---|
| 根目錄 | 整棵樹的起點 | Mac 是 /，Windows 是 C:\ |
| 資料夾 | 用來分類整理檔案的容器，可以無限巢狀 | Documents/ |
| 檔案 | 實際存放內容的單位，有名稱和副檔名 | app.py |
| 副檔名 | 檔名後面的點和幾個字母，告訴電腦這是什麼類型的檔案 | .py、.html、.env |
副檔名決定電腦用什麼程式開啟這個檔案，也決定它能做什麼。Vibe Coder 最常遇到的副檔名如下：
| 副檔名 | 是什麼 | 用途 |
|---|---|---|
.py | Python 程式 | 後端邏輯、自動化腳本 |
.html | 網頁結構 | 前端頁面 |
.css | 樣式表 | 控制網頁外觀 |
.js | JavaScript | 網頁互動邏輯 |
.env | 環境變數設定 | 存放 API Key 等敏感資訊 |
.json | 資料格式 | 設定檔、API 回傳資料 |
.md | Markdown 文件 | README、說明文件 |
app 其實是 app.py。改名時不小心變成 app.py.txt，程式就跑不起來。修正方式：打開「檔案總管」到「檢視」，勾選「副檔名」；Mac 則在 Finder 偏好設定裡打開「顯示所有副檔名」。路徑：告訴電腦東西在哪裡
路徑就是檔案的地址。就像你要告訴人家你家在哪裡，要說完整地址，電腦也需要完整地址才能找到檔案。
| 類型 | 定義 | Mac / Linux 範例 | Windows 範例 |
|---|---|---|---|
| 絕對路徑 | 從根目錄開始的完整地址，永遠找得到 | /Users/joan/project/app.py | C:\Users\joan\project\app.py |
| 相對路徑 | 從「目前所在位置」開始的相對地址 | ./app.py 或 ../data/ | .\app.py 或 ..\data\ |
.（一個點）代表目前資料夾，./app.py 就是「目前資料夾裡的 app.py」。..（兩個點）代表上一層資料夾，../data/ 就是「上一層裡的 data 資料夾」。~（波浪號）代表你的家目錄（Mac 與 Linux），~/Desktop/ 就是桌面。Mac 和 Linux 用斜線 /，Windows 用反斜線 \。AI 給的路徑常常是 Mac 格式，在 Windows 上要手動換；現代 Windows 的 PowerShell 和 WSL 已可以接受 /，但遇到錯誤時要注意這個差異。
"/Users/joan/my project/"，不然電腦會以為是兩個不同的路徑。大小寫問題：Mac 和 Linux 的路徑區分大小寫，App.py 和 app.py 是不同的檔案；Windows 不區分，但還是建議統一小寫。終端機入門：四個指令活下去
終端機（Terminal）是你用文字指令跟電腦溝通的介面。AI 給你的所有安裝步驟、執行指令，都要在這裡輸入。不用怕，學會四個指令就能應付九成場景。
| 系統 | 開啟方式 | 預設 Shell |
|---|---|---|
| Mac | Spotlight 搜尋「Terminal」或「iTerm2」 | zsh |
| Windows | 搜尋「PowerShell」或安裝「Windows Terminal」 | PowerShell |
| Linux | Ctrl + Alt + T，或應用程式選單找「終端機」 | bash |
- pwd（Print Working Directory）：我在哪裡？顯示目前所在的資料夾路徑，迷路時第一個打這個。
- ls（List）：這裡有什麼？列出目前資料夾的所有檔案和資料夾，Windows PowerShell 用
dir或同樣支援ls。 - cd 路徑（Change Directory）：去那裡。切換到指定資料夾，
cd ..回上一層，cd ~回家目錄。 - mkdir 名稱（Make Directory）：建立資料夾，例如
mkdir my-project。
# 完整流程示範：建立並進入專案資料夾
pwd # 確認目前位置
# 輸出：/Users/joan
mkdir my-project # 建立新資料夾
cd my-project # 進入該資料夾
pwd # 再次確認
# 輸出：/Users/joan/my-project
ls # 列出內容（剛建立，是空的）執行檔與權限：為什麼點兩下沒反應
不是所有檔案點兩下都會「跑起來」。電腦有執行權限的概念，而且不同類型的檔案需要不同的方式執行。
| 檔案類型 | 執行方式 | 指令範例 |
|---|---|---|
| .py | 用 Python 直譯器執行 | python app.py |
| .js | 用 Node.js 執行 | node server.js |
| .sh | 用 bash 執行（Mac 與 Linux） | bash setup.sh |
| npm 專案 | 用 npm 啟動 | npm run dev |
| pip 套件 | 先安裝再 import 使用 | pip install requests |
python 可能跑到舊版，要用 python3。Windows 安裝 Python 3 後通常直接是 python。確認版本用 python3 --version，應看到 Python 3.11.x 以上。常見卡關速查
以下是 Vibe Coder 最高頻的卡關場景，遇到時先查這裡，再去問 AI。
| 錯誤訊息 | 原因 | 解法 |
|---|---|---|
| command not found | 這個指令沒有安裝，或沒有加入 PATH | 確認有沒有安裝（如 Python、Node），或重新安裝並勾選「Add to PATH」 |
| No such file or directory | 路徑錯了，或檔案不存在 | 用 ls 確認檔案在不在，用 pwd 確認你在哪個資料夾 |
| Permission denied | 沒有執行或讀取的權限 | Mac 與 Linux 加 chmod +x 檔名，或用 sudo（謹慎使用） |
| ModuleNotFoundError | Python 套件沒安裝，或虛擬環境沒啟動 | pip install 套件名，並確認 (.venv) 有出現在終端機前面 |
| Port already in use | 這個通訊埠已經被其他程式佔用 | 換一個 port（如 8001），或關掉佔用的程式 |
| 程式跑了但沒有輸出 | 可能卡在等待輸入，或邏輯有問題 | 按 Ctrl+C 強制停止，再檢查程式邏輯 |
pwd）？環境裝了嗎？虛擬環境啟動了嗎？第三，把完整錯誤訊息貼給 AI，不要只說「壞掉了」，要把整段紅字複製貼上，並說明你在哪個步驟、執行了什麼指令。延伸學習
做出你的第一個 Skill
一場快閃直播的完整重製。從搞懂 Skill 的五個層級開始，帶你把一件你每天在做的重複工作，寫成一支 AI 真的會照做的 Skill ── 命名、description、輸入拆解、Workflow 訪談、Output 與 Checks，最後組成一份能通過格式檢查的 SKILL.md。
NT$ 999
HE101｜Harness Engineering Foundation（3 小時）
三小時的地圖課，不是操作課。把 Model 與 AI System 分開，拆解一套 AI Harness 的八個組成（Goal、Context、Knowledge、Rules、Tools、Workflow、Evaluation、Iteration），再帶你逆向拆解四個你已經在用的系統，最後畫出自己的第一張 Harness Blueprint。5 章 27 課，附學員講義 PDF 與術語速查表。
NT$ 2,599