檔案、路徑、網址 —— 看懂它們，工作就順了

檔案與路徑

電腦裡的東西分兩種：資料夾（folder，用來裝東西的盒子）和 檔案（file，實際的內容）。資料夾裡可以再放資料夾，一層一層像俄羅斯娃娃。

主檔名 + 副檔名

一個檔案的名字通常長這樣，用最後一個「點」切成兩段：

副檔名（點後面那一小段）超重要 —— 它告訴電腦「這是哪一種檔」，也決定用什麼程式打開。改錯或刪掉副檔名，檔案就可能打不開。

隱藏檔（名字開頭是「.」）

檔名開頭就是一個點的檔（像 .env、.gitignore）是「隱藏檔」，電腦預設不顯示，免得你誤刪重要設定。要看到它們：

• Mac 檔案總管（Finder）裡：按快捷鍵 ⌘ Cmd + ⇧ Shift + .（就是那個句點）→ 隱藏檔會半透明浮現；再按一次收回。
• 終端機（Terminal）裡：一般用 ls 列出檔案；要連隱藏檔一起看就加 -a → 打 ls -a。

Finder 常用操作

• 複製 / 貼上：選檔 → ⌘ + C 複製 → 到目標資料夾 → ⌘ + V 貼上。
• 新增資料夾：在空白處按右鍵（或雙指點觸控板）→「新增檔案夾」，或 ⌘ + ⇧ + N。
• 新增檔案：Finder 沒有「新增空白檔」按鈕；通常是從程式裡「另存新檔」到你要的資料夾，或用終端機。
• 重新命名：點一下檔名 → 按 Enter / Return → 改字。改名時別動到副檔名（點後面那段）。

絕對路徑 vs 相對路徑

「路徑」就是檔案的地址 —— 怎麼一層層找到它。有兩種寫法：

絕對路徑：從最頂端（/）開始寫全，像完整地址。放到任何地方都指同一個檔：

相對路徑：相對於你「現在所在的資料夾」來寫，像「從這裡往下走」。同一個檔，若你人在專案資料夾 sageio-web 裡，就只要寫：

我們專案的資料夾長這樣

網址與位址

網址（URL）也是一種「地址」—— 只是它指的是網路上的一個頁面。它一樣有結構，一段一段拆開看就懂：

• https:// 是協定：https 的 s = secure（加密安全），比 http 安全。
• sageio.net 是網域：這個網站的名字，像大樓的門牌。
• /blog/best-meeting-translation-tools 是路徑：大樓裡的哪個房間 —— 這裡就是那篇文章的頁面。

網域 vs IP 位址

電腦之間其實是用一串數字 IP 位址（像 76.76.21.21）找到彼此的。但數字難記，所以有網域名稱（sageio.net）當「給人看的名字」，背後自動對應到那串 IP。網域 = 好記的名字；IP = 真正的門牌號碼。

localhost 和 port（埠）

有時你會看到這種網址：

• localhost 永遠指你自己正在用的這台電腦（不是網路上別人的伺服器）。
• :8787 是埠號：同一台電腦上可以同時跑很多服務，用不同號碼分開，像同一棟大樓的不同門號。

網址的路徑，對應到檔案

還記得模組 1 那個 .mdx 檔嗎？網站上的網址路徑，其實就對應到 repo 裡的檔案：

看到沒？網址最後那段，就是檔案的主檔名。改哪個檔，就會影響哪個網址的頁面 —— 這就是你的翻譯/校對會生效在哪裡。

這些在你的工作裡長怎樣

把前面兩塊接回你實際會遇到的東西：

Ming 給你的指令 open -t "…"

open -t = 用文字編輯器打開後面那個檔。引號裡就是絕對路徑（模組 1 學過）。你把整行貼到終端機、按 Enter，那個檔就開了。

Issue 裡要你「檢查某個網址」

例如「確認 https://sageio.net/type 回 200」。200 是網頁的狀態碼，代表頁面正常、載入成功；常見的還有 404（找不到頁面）、500（伺服器出錯）。看到 200 就是好消息。

你改翻譯，改的是哪個檔

你做 Type / 文章翻譯時，改的多半是 .json（翻譯字串）或 .mdx（文章）。改完透過 GitHub 開 PR，Claude 幫你檢查、Ming 核可後合併，網站就更新了。

工程術語表

你在 issue、PR、跟工程師對話時會一直聽到這些英文詞。你不用會「做」，只要看到不心慌、知道大概在講什麼就夠了。都用我們的專案舉例。