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/docs/web/before-you-start.md (or send Accept: text/markdown).

开始之前

安装 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 官方安装程序

node --version
npm --version

3.安装Git和文本编辑器

打开下面的 Git 下载页面，选择您的操作系统并按照其安装程序进行操作。 Git 下载您的私有存储库并记录文件更改。在 macOS 上，运行以下命令可能会提供 Apple 的命令行工具安装；接受它并在完成后重新运行该命令。在 Linux 上，使用 Git 页面上针对您的发行版显示的安装命令。

从其官方下载页面安装 Visual Studio Code。这是一个用于打开项目和保存配置文件的文本编辑器。打开它，选择“文件”→“打开文件夹”（在 macOS 上“文件”→“打开”），然后选择您下载的 supastack 文件夹。您无需编写代码即可完成首次本地演示。

在新打开的终端中，运行以下命令。结果以 git version 开头表示 Git 已准备就绪。如果命令丢失，请完成安装程序并重新打开终端。

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认证帮助

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；如果报告权限错误，请改用过滤后的首次运行命令。

了解如何运行命令和编辑文件

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 和原生构建工具，其教程会在启动命令之前讲解。