你會遇到的詞

檔案與資料夾

這些詞描述的是你下載的程式碼。每當安裝指南讓你開啟或編輯檔案時，都會用到這些名字。

• 儲存庫（Repository）——專案資料夾加上它的全部變更歷史，託管在 GitHub 上並複製到你的計算機。
• 克隆（Clone）——儲存庫在你計算機上的副本；由 git clone 命令建立。
• Monorepo——一個儲存庫中放多個應用和共享包；All Platforms 套裝就是一個 monorepo。
• package.json——每個應用或包裡都有的檔案，列出它的名字、命令和所需的庫。
• pnpm-workspace.yaml——monorepo 根部的檔案，列出哪些資料夾屬於該工作區。
• 鎖定檔案（Lockfile）——記錄每個已安裝庫確切版本的檔案，保證每次安裝結果一致。

計算機上的工具

首次執行前安裝一次的程式。指南會在 node --version 這類命令中提到它們。

• 終端（Terminal）——輸入命令的視窗，比如 Windows 上的 PowerShell 或 macOS 上的 Terminal。
• Node.js——在瀏覽器之外執行 JavaScript 的程式；套件的伺服器和指令碼都跑在它上面。
• npm——隨 Node.js 捆綁的庫安裝器；在本套件中你主要用它來啟用 Corepack。
• Corepack——啟用專案所指定的確切包管理器版本的工具。
• pnpm——下載庫並執行專案指令碼的包管理器；通過 corepack pnpm 呼叫。
• Git——下載你的儲存庫並記錄你對它所做每一次改動的工具。
• 編輯器或 IDE——用來開啟資料夾、編輯檔案的應用；指南使用 Visual Studio Code。

配置用詞

設定儲存在檔案裡，而不是終端裡。這些詞說明它們的位置和叫法。

• 環境變數——形如 EMAIL_PROVIDER=local 的具名設定，改變應用的行為。
• .env——儲存庫根部的檔案，存放資料庫遷移等命令使用的設定。
• .env.local——單個應用的設定檔案，比如 Web 伺服器使用 apps/web-tanstack/.env.local。
• 機密（Secret）——必須保持私密的值，比如密碼或簽名金鑰；絕不提交它，也別粘進對話。
• API key——外部服務給你的機密字串，讓它認出你的應用是合法呼叫方。
• 提供商（Provider）——套件可用於 AI、郵件、計費、儲存等工作的外部服務。

產品裡用到的詞

執行中的應用及其設定介面使用這些術語。Workspace 帶有兩個不同含義——注意看上下文。

• 工作區（Workspace）——在產品中，指一個團隊各自獨立的使用者、資料和設定；在 pnpm 命令中，指 monorepo 內的一個包資料夾，用 --filter 選擇。
• 授權（Entitlement）——伺服器上記錄某個工作區被允許使用付費功能的憑證。
• 遷移（Migration）——建立或更新資料表的帶版本資料庫變更；用命令應用遷移。
• 會話（Session）——告訴伺服器“誰在請求”的登入狀態，直到過期或你退出登入。
• Webhook——外部服務在某事發生（比如賬單已支付）時傳送到你應用 URL 的訊息。
• 賬戶與組織（Account vs organization）——賬戶是一個人的登入身份；組織是成員加入的團隊共享空間，也叫工作區。

Web 開發用詞

當你在瀏覽器中開啟應用時，執行、構建和部署指南會用到這些詞。

Ctrl + C 指按住 Ctrl、點按 C 再鬆開——它會停止終端中正在執行的命令。

• 動手學習命令、檔案和配置
• 如何使用這些檔案

• localhost——瀏覽器地址中“這臺計算機”的名字；開發期間你的應用就跑在那裡。
• 埠（Port）——localhost 後面那道帶編號的門，比如 :3000；每個執行中的應用各用一扇。
• 開發伺服器（Dev server）——你工作時持續重建並伺服應用的命令；用 Ctrl + C 停止。
• 構建（Build）——把原始碼變成伺服器可部署的最佳化檔案的那一步。
• 伺服器渲染（SSR）——伺服器先組裝好頁面再傳送，讓第一屏內容完整到達。