For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/web/glossary.md (or send Accept: text/markdown).
你會遇到的詞
用大白話解釋安裝指南、錯誤資訊和產品本身會用到的術語。
檔案與資料夾
這些詞描述的是你下載的程式碼。每當安裝指南讓你開啟或編輯檔案時,都會用到這些名字。
- 儲存庫(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/.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)——伺服器先組裝好頁面再傳送,讓第一屏內容完整到達。