sub-cli/docs/zh-Hans/installation.md

title	description
安装指南	如何在您的系统上下载并安装 Sub-CLI

安装指南

按照以下简单步骤，在您的计算机上安装并运行 Sub-CLI。

下载正确的版本

Sub-CLI 适用于各种操作系统和架构。访问发布页下载适合您系统的版本。

了解应下载哪个版本

发布文件的命名遵循以下模式：

sub-cli-[操作系统]-[架构][.exe]

其中：

• 操作系统是您的操作系统（windows, darwin, linux）
• 架构是您计算机的处理器类型（amd64, arm64）
• .exe扩展名仅适用于Windows版本

我需要哪个版本？

以下是一个简单的选择指南：

操作系统	处理器类型	下载文件
Windows	Intel/AMD（大多数PC）	sub-cli-windows-amd64.exe
Windows	ARM（如Surface Pro X等）	sub-cli-windows-arm64.exe
macOS	Intel Mac	sub-cli-darwin-amd64
macOS	Apple Silicon（M系列处理器）	sub-cli-darwin-arm64
Linux	Intel/AMD（大多数PC/服务器）	sub-cli-linux-amd64
Linux	ARM（树莓派，基于ARM的VPS等）	sub-cli-linux-arm64

如果您不确定系统架构，大多数现代计算机使用amd64（也称为x86_64）架构。

安装步骤

::: tip

如果只想临时使用，您只需将 sub-cli 放在当前目录或你期望的位置，无需将其加入环境变量。

:::

Windows

1. 从发布页面下载适合的.exe文件
2. 将文件移动到您选择的位置（例如，C:\Users\[用户名]\bin\）
3. （可选）将该文件夹添加到PATH环境变量中，以便从任何位置运行Sub-CLI：
   • 右键点击"此电脑"并选择"属性"
   • 点击"高级系统设置"
   • 点击"环境变量"
   • 在"系统变量"下，找到"Path"变量，选择它并点击"编辑"
   • 点击"新建"并添加包含Sub-CLI可执行文件的文件夹路径
   • 点击所有对话框上的"确定"保存更改

macOS (Darwin)

1. 从发布页面下载适合的文件
2. 打开终端
3. 使用以下命令使文件可执行：

   chmod +x path/to/downloaded/sub-cli-darwin-[架构]
   

4. （可选）将其移动到PATH中的位置以便更容易访问：

   sudo mv path/to/downloaded/sub-cli-darwin-[架构] ~/.local/bin/sub-cli
   

Linux

1. 从发布页面下载适合的文件
2. 打开终端
3. 使用以下命令使文件可执行：

   chmod +x path/to/downloaded/sub-cli-linux-[架构]
   

4. （可选）将其移动到PATH中的位置以便更容易访问：

   sudo mv path/to/downloaded/sub-cli-linux-[架构] ~/.local/bin/sub-cli
   

验证安装

要验证Sub-CLI是否正确安装，打开命令提示符或终端并运行：

sub-cli version

您应该看到显示的Sub-CLI当前版本号。

故障排除

如果在安装过程中遇到任何问题：

• 确保您已下载适合您操作系统和架构的正确版本
• 确保文件具有可执行权限（在macOS和Linux上）
• 验证文件位于命令提示符或终端可访问的位置
• 如果您已将其添加到PATH中，尝试重启命令提示符或终端

如需进一步帮助，请访问我们的反馈页面报告问题。