开始之前

1. 选择您要运行的内容

使用一台已联网的 Windows、macOS 或 Linux 计算机。Desktop 应用就是安装在这台计算机上的原生窗口——不涉及手机。下面的步骤会安装它的工具并下载项目。

存储库是您通过 GitHub 获得的存放文件的文件夹。购买 Desktop 会获得 Desktop 套件存储库；All Platforms 套餐提供 monorepo，即包含全部三个应用的文件夹。请接受您所购存储库的邀请。Desktop 存储库包含 Tauri 外壳——包裹您的 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 安装程序
• Visual Studio Code下载

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。Desktop 版本的 checkout 在 apps 内只显示桌面外壳；All Platforms monorepo 还会显示 web 和 mobile 应用。这就是存储库根目录。如果 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. 安装 Rust 和原生构建工具

在 Windows 上，使用下面的 Tauri 先决条件链接安装 Microsoft C++ 构建工具。在其安装程序中选择“使用 C++ 进行桌面开发”，保持选择“Windows SDK”并完成安装。确保已安装 Microsoft Edge WebView2 运行时。使用 rustup-init.exe 从 rustup.rs 安装 Rust；保留默认的 MSVC 工具链。安装后重新打开终端。

在 macOS 上，在终端中运行 xcode-select --install 并完成命令行工具对话框（如果未安装）。使用 rustup.rs 中的 macOS 命令安装 Rust。在 Linux 上，按照 Tauri 先决条件页面获取您的确切发行版的 WebKitGTK、编译器、托盘和系统库包，然后安装 Rust。 Linux 软件包名称各不相同；不要运行其他发行版的命令。

在存储库根目录打开终端并运行下面的版本检查。 rustc和cargo都必须打印版本； cargo 是 Rust 的构建工具。如果其中一个缺失，请完成安装并重新打开终端，然后再继续。

• Tauri 操作系统先决条件清单
• 官方 Rust 安装程序

rustc --version
cargo --version

8. 继续阅读 Desktop 指南

当 Node 和 Git 能打印出版本号、Corepack 能选择锁定的 pnpm、rustc 和 cargo 能打印出版本号、且您的终端位于包含 package.json 的文件夹中时，您就准备就绪了。从下面选择一个教程。

• 让代理替你跑安装
• 运行 Desktop 应用
• 了解 Desktop 技术栈