> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 開始之前

安裝 Node.js、Git 和編輯器，接受儲存庫邀請，下載套件並檢查您的計算機是否已準備好首次執行。

## 1. 選擇您要執行的內容

使用具有網際網路連線的 Windows、macOS 或 Linux 計算機。瀏覽器執行 Web 應用程式；手機執行移動應用程式；桌面應用程式在其自己的視窗中開啟。您的手機無法單獨執行以下安裝步驟。

儲存庫是您通過 GitHub 收到的檔案的資料夾。 Web、移動和桌面購買均提供相應的套件儲存庫；所有平臺捆綁包提供 monorepo，一個包含所有三個應用程式的資料夾。接受您購買的儲存庫的邀請。移動或桌面結帳仍然需要可訪問的 Web 後端：處理帳戶和資料的伺服器。這些客戶端儲存庫不包括 Web 伺服器。

這些工具準備好一次。下載工具和第一次本機編譯可能需要超過五分鐘的時間。在這些準備工作之後，五分鐘的指南開始；本地執行不會將您的應用程式釋出到網際網路。


## 2.安裝Node.js

開啟下面的Node.js官方下載頁面。選擇編號為 22 或更高的 LTS 版本以及適合您計算機的安裝程式：Windows 上的 .msi 或 macOS 上的 .pkg。開啟下載的安裝程式，保留預設值並完成安裝。 Node.js 讓您的計算機執行應用程式的 JavaScript； npm 隨其安裝。

安裝後關閉並重新開啟終端。在 Windows 上開啟“開始”，鍵入 PowerShell 並將其開啟。在 macOS 上，按 Command + Space，輸入 Terminal，然後按 Enter。在 Linux 上，從應用程式選單中開啟終端。貼上下面的命令，然後按 Enter。 v22.x.x 或 v24.x.x 等結果確認節點可用。如果您看到命令未找到或無法識別，請重新開啟終端或重新安裝節點並啟用其 PATH 選項。

[Node.js 官方安裝程式](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3.安裝Git和文本編輯器

開啟下面的 Git 下載頁面，選擇您的作業系統並按照其安裝程式進行操作。 Git 下載您的私有儲存庫並記錄檔案更改。在 macOS 上，執行以下命令可能會提供 Apple 的命令列工具安裝；接受它並在完成後重新執行該命令。在 Linux 上，使用 Git 頁面上針對您的發行版顯示的安裝命令。

從其官方下載頁面安裝 Visual Studio Code。這是一個用於開啟專案和儲存配置檔案的文本編輯器。開啟它，選擇“檔案”→“開啟資料夾”（在 macOS 上“檔案”→“開啟”），然後選擇您下載的 supastack 資料夾。您無需編寫程式碼即可完成首次本地演示。

在新開啟的終端中，執行以下命令。結果以 git version 開頭表示 Git 已準備就緒。如果命令丟失，請完成安裝程式並重新開啟終端。

[官方 Git 安裝程式](https://git-scm.com/downloads/)

[Visual Studio Code下載](https://code.visualstudio.com/download)

```
git --version
```


## 4.接受您的GitHub邀請

使用您購買時提供的帳戶在瀏覽器中登入 GitHub。開啟您的 GitHub 邀請電子郵件，選擇檢視邀請並接受訪問。然後開啟邀請的儲存庫。您應該看到它的檔案和一個綠色的程式碼按鈕。 404 通常意味著邀請尚未被接受或者您登入到了不同的 GitHub 帳戶。

選擇程式碼 → 本地 → HTTPS 並複製顯示的地址。在下一步中使用該確切地址。包含尖括號的示例地址是模板：替換它們而不是貼上括號。您不需要猜測組織名稱或將私有儲存庫公開。


## 5. 將專案下載到您的計算機上

為您的專案選擇一個資料夾，例如檔案。在檔案資源管理器或 Finder 中開啟該資料夾。在 Windows 上，右鍵單擊空白區域並選擇在終端中開啟，然後根據需要選擇 PowerShell。在 macOS 上開啟終端，輸入 cd 後跟一個空格，將資料夾拖到終端中，然後按 Enter。終端現在正在該資料夾中工作。

在下面的第一個命令中，將 YOUR_COPIED_HTTPS_ADDRESS 替換為您剛剛複製的 HTTPS 地址。一次執行一行。第一行建立一個名為supastack的新資料夾；第二行進入其中。如果 Git 要求您登入，請完成瀏覽器登入。不要使用您的 GitHub 帳戶密碼作為 Git 密碼。如果瀏覽器登入不可用，請按照下面連結的 GitHub 的 HTTPS 身份驗證指南進行操作。

成功：supastack 資料夾包含 package.json、pnpm-workspace.yaml、apps 和 packages。這是儲存庫根目錄。如果 Git 說目標已經存在，請使用其他空資料夾或開啟現有克隆；不要刪除你的作品。保持該終端開啟以進行下一步。

[GitHub HTTPS認證幫助](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6.檢查Corepack和固定的包管理器

執行下面的第一個命令。 Corepack選擇package.json中記錄的pnpm版本； pnpm 下載專案使用的庫。如果 Corepack 請求下載該版本的許可權，請鍵入 y 並按 Enter。本次檢查引腳 pnpm 11.19.0；保留其引腳而不是選擇不同的包管理器。

如果核心包丟失，請執行 npm install --global corepack，重新開啟終端並重試。如果 PowerShell 表示 npm.ps1 或 corepack.ps1 指令碼無法執行，請使用 npm.cmd 或 corepack.cmd 執行該命令，包括 corepack.cmd pnpm install。您不需要更改計算機的執行策略。

過濾後的首次執行命令直接呼叫Corepack。如果您使用 corepack pnpm dev 等 Turbo 命令，Turbo 還需要 PATH 上的 pnpm 命令。下面的 Windows 設定會在使用者可寫的資料夾中建立該命令；其 PATH 更改僅持續當前終端。如果 pnpm 丟失，請在開啟新終端後再次執行此塊。在 macOS/Linux 上，執行 corepack enable；如果報告許可權錯誤，請改用過濾後的首次執行命令。

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

```
corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"
```


## 7. 繼續使用您的平臺

當 Node 和 Git 能列印版本號、Corepack 能選中固定的 pnpm，且終端位於包含 package.json 的資料夾時，你就準備好了。從下面選一個教程。Web 演示中 Docker 是可選的；真實賬戶稍後需要資料庫。Desktop 還需要 Rust 和原生構建工具，其教程會在啟動命令之前講解。

[讓代理替你跑安裝](https://supastack.dev/zh-tw/docs/web/agent-setup.md)

[執行 Web 應用](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

[執行 Mobile 應用](https://supastack.dev/zh-tw/docs/mobile/ship-in-5-minutes.md)

[執行 Desktop 應用](https://supastack.dev/zh-tw/docs/desktop/ship-in-5-minutes.md)


## 下一篇

[命令、檔案和配置](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)