Skip to content
This repository was archived by the owner on Jul 30, 2025. It is now read-only.

Commit 247b4ac

Browse files
WGB5445WGB5445
authored
[ì8n] upgrade zh build/install-cli/*.mdx (#920)
fix: update zh build/install-cli/
1 parent 8860ef0 commit 247b4ac

File tree

4 files changed

+166
-97
lines changed

4 files changed

+166
-97
lines changed

‎apps/nextra/pages/zh/build/cli/install-cli/install-cli-linux.mdx‎

Lines changed: 49 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -2,69 +2,82 @@ import { Callout, Steps } from 'nextra/components'
22

33
# 在 Linux 上安装 Aptos CLI
44

5-
对于 Linux，安装 Aptos CLI 工具最简单的方法是通过 Python 脚本，不过如果这种方法不起作用，你也可以通过下载预编译二进制文件手动安装。不建议使用预编译二进制文件的方法，因为更新过程非常手动。
5+
对于 Linux 系统，安装 Aptos CLI 工具最简单的方式是通过 shell 脚本。如果脚本方式不可行，您也可以通过下载预编译二进制文件进行手动安装。不过一般不推荐预编译二进制文件的方式，因为更新过程非常手动化。
66

7-
<Callout type="warning">
8-
注意：如果你使用的是 ARM 架构，你需要按照以下步骤安装：[安装特定版本的 Aptos CLI (高级)](install-cli-specific-version.mdx)
9-
</Callout>
10-
11-
# 通过 Python 脚本安装
7+
# 通过脚本安装
128

139
<Steps>
14-
### 通过运行 `python3 --version` 确保已安装 Python 3.6+。
15-
16-
如果未安装 python3，你可以在 [python.org](http://python.org) 找到安装说明。
1710

18-
### 在终端中，使用以下命令之一：
11+
### 在终端中使用以下任一命令：
1912

20-
{/* TODO We need to ensure these files are still hosted */}
2113
```bash filename="Terminal"
22-
curl -fsSL "https://aptos.dev/scripts/install_cli.py" | python3
14+
curl -fsSL "https://aptos.dev/scripts/install_cli.sh" | sh
2315
```
2416

2517
或使用等效的 `wget` 命令：
2618

2719
```bash filename="Terminal"
28-
wget -qO- "https://aptos.dev/scripts/install_cli.py" | python3
20+
wget -qO- "https://aptos.dev/scripts/install_cli.sh" | sh
2921
```
3022

3123
<Callout type="warning">
32-
如果你收到错误 `Couldn't find distutils or packaging. We cannot check the current version of the CLI. We will install the latest version.`，你可以通过运行 `pip3 install packaging` 然后重复此步骤来修复它。
24+
如果运行 CLI 时遇到 `Illegal instruction` 错误，可能是由于您的 CPU 不支持 SIMD 指令。
25+
特别是对于较旧的非 SIMD 处理器或在 ARM Mac 上的 Ubuntu x86_64 docker 容器，您可能需要改用以下命令来跳过 SIMD 指令：
26+
```bash filename="Terminal"
27+
curl -fsSL "https://aptos.dev/scripts/install_cli.sh" | sh -s -- --generic-linux
28+
```
3329
</Callout>
3430

35-
### (可选) 将 Aptos CLI 添加到 PATH 中的文件夹，或直接将其添加到 PATH 中会很有帮助。
36-
- 将文件夹添加到 PATH 的步骤取决于 shell。
37-
- 你可以运行 `echo $SHELL` 来打印机器的默认 shell，然后搜索该 shell 将文件夹添加到 PATH 的具体步骤。
38-
### 通过打开新终端并运行 `aptos help` 来验证脚本是否已安装
39-
- 你应该看到可以使用 CLI 运行的命令列表。
40-
- 将来，这是一个有用的资源，可以了解每个命令的具体工作方式。
31+
### （可选）将 Aptos CLI 添加到 PATH 目录或直接添加到 PATH 会很有帮助。
32+
- 将目录添加到 PATH 的步骤取决于您使用的 shell。
33+
- 您可以运行 `echo $SHELL` 来打印机器的默认 shell，然后搜索针对该 shell 添加目录到 PATH 的具体步骤。
34+
### 打开新终端并运行 `aptos help` 来验证安装是否成功
35+
- 您应该能看到 CLI 可运行的命令列表。
36+
- 未来这将是一个有用的资源，可以详细了解每个命令的工作原理。
4137
</Steps>
4238

4339
<Callout type="info" emoji="ℹ️">
44-
如果你想将 Aptos CLI 更新到最新版本，可以运行 `aptos update`。
40+
如果想将 Aptos CLI 更新到最新版本，可以运行 `aptos update`。
41+
</Callout>
42+
43+
# 通过包管理器安装（可选）
44+
45+
<Callout type="info">
46+
通过包管理器安装 Aptos 后，未来请通过相同的包管理器进行更新。
4547
</Callout>
4648

49+
### Arch Linux
50+
#### 通过 AUR (Arch 用户仓库) 安装
51+
```bash filename="Terminal"
52+
git clone https://aur.archlinux.org/aptos-bin.git
53+
cd aptos-bin
54+
makepkg -si
55+
```
56+
或使用 AUR 助手如 `yay`：
57+
```bash filename="Terminal"
58+
yay -S aptos-bin
59+
```
4760
# 通过预编译二进制文件安装（备用方法）
4861

4962
<Steps>
50-
### 转到 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli&expanded=true)。
51-
### 点击最新发布的"Assets"可展开菜单以查看预编译二进制文件。
52-
### 下载 Linux 的 zip 文件。
53-
1. 它的名称类似：`aptos-cli-<version>-Ubuntu-x86_64.zip`。
54-
2. 确保选择适合你计算机架构的 zip 文件。
55-
3. 下载时你可能需要忽略这是可疑文件的警告。
63+
### 访问 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli&expanded=true)。
64+
### 点击最新版本的 "Assets" 可展开菜单查看预编译二进制文件。
65+
### 下载适用于 Linux 的 zip 文件。
66+
1. 文件名类似：`aptos-cli-<version>-Linux-x86_64.zip` 或 `aptos-cli-<version>-Linux-aarch64.zip`。
67+
2. 确保选择与您计算机架构匹配的 zip 文件（x86_64 对应 Intel/AMD，aarch64 对应 ARM）。
68+
3. 下载时可能需要忽略关于该文件可疑的警告。
5669
### 解压下载的文件。
57-
### 将提取的 Aptos 二进制文件移动到你喜欢的文件夹中。
58-
### 打开终端并导航到你喜欢的文件夹。
70+
### 移动将提取的 Aptos 二进制文件放入您偏好的文件夹。
71+
### 打开终端并导航至您偏好的文件夹。
5972
### 通过运行 `chmod +x ~/aptos` 使 `~/aptos` 成为可执行文件。
60-
### 通过运行 `~/aptos help` 验证此安装版本是否有效。
61-
你应该看到如何使用所有 CLI 命令的说明。将来当你试图了解如何使用特定命令时，这些说明会很有帮助。
62-
### (可选) 将 Aptos CLI 添加到 PATH 中的文件夹，或直接将其添加到 PATH 中会很有帮助。
63-
- 将文件夹添加到 PATH 的步骤取决于 shell。
64-
- 你可以运行 `echo $SHELL` 来打印机器的默认 shell，然后搜索该 shell 将文件夹添加到 PATH 的具体步骤。
73+
### 运行 `~/aptos help` 验证已安装版本是否正常工作。
74+
您应该会看到所有 CLI 命令的使用说明。这些说明在未来尝试理解如何使用特定命令时会很有帮助。
75+
### （可选）将 Aptos CLI 添加到 PATH 环境变量的某个文件夹，或直接添加到 PATH 会很有帮助。
76+
- 将文件夹添加到 PATH 的步骤取决于您使用的 shell。
77+
- 您可以运行 `echo $SHELL` 打印您机器的默认 shell，然后通过搜索了解为该 shell 添加文件夹到 PATH 的具体步骤。
6578

6679
</Steps>
6780

6881
<Callout type="info" emoji="ℹ️">
69-
使用预编译二进制文件方法时，你可以通过删除现有安装，然后再次按照安装步骤操作来更新 Aptos CLI。
70-
</Callout>
82+
当使用预编译二进制文件安装方式时，你可以通过删除现有安装，然后重新执行安装步骤来更新 Aptos CLI。
83+
</Callout>

‎apps/nextra/pages/zh/build/cli/install-cli/install-cli-mac.mdx‎

Lines changed: 63 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,35 +2,87 @@ import { Callout, Steps } from 'nextra/components'
22

33
# 在 Mac 上安装 Aptos CLI
44

5-
在 Mac 上，安装 Aptos CLI 最简单的方法是使用包管理器 `brew`。
5+
对于 Mac 用户，安装 Aptos CLI 最简单的方法是使用包管理器 `brew`。
66

7-
# 安装
7+
# 安装步骤
88

99
<Steps>
10-
### 确保已安装 `brew` https://brew.sh/ 。
11-
### 打开新的终端并输入以下命令。
10+
### 确保已安装 `brew` https://brew.sh/
11+
### 打开新终端并输入以下命令
1212

13-
```bash filename="Terminal"
13+
```bash filename="终端"
1414
brew update
1515
brew install aptos
1616
```
1717

18-
### 打开另一个终端并运行 `aptos help` 来验证 CLI 是否已安装。
18+
### 打开另一个终端并运行 `aptos help` 验证 CLI 是否安装成功
1919

20-
```bash filename="Terminal"
20+
```bash filename="终端"
2121
aptos help
2222
```
2323
</Steps>
2424

2525
<Callout type="warning">
26-
如果 `brew` 不适合你，你可以尝试这里的步骤：[安装特定版本的 Aptos CLI (高级)](install-cli-specific-version.mdx)
26+
如果 `brew` 不可用，可以尝试以下方法：[通过脚本安装](#install-via-script) 或 [通过预编译二进制文件安装](#install-via-pre-compiled-binaries-backup-method)
2727
</Callout>
2828

2929
# 升级 CLI
3030

31-
使用 brew 升级 CLI 只需要 2 个命令：
31+
使用 brew 升级 CLI 只需两条命令：
3232

33-
```bash filename="Terminal"
33+
```bash filename="终端"
3434
brew update
3535
brew upgrade aptos
36-
```
36+
```
37+
38+
# 通过脚本安装
39+
40+
<Steps>
41+
### 在终端使用以下任一命令：
42+
43+
```bash filename="终端"
44+
curl -fsSL "https://aptos.dev/scripts/install_cli.sh" | sh
45+
```
46+
47+
或使用等效的 `wget` 命令：
48+
49+
```bash filename="终端"
50+
wget -qO- "https://aptos.dev/scripts/install_cli.sh" | sh
51+
```
52+
53+
### （可选）建议将 Aptos CLI 添加到 PATH 路径中的文件夹
54+
- 添加文件夹到 PATH 的具体步骤取决于使用的 shell
55+
- 可运行 `echo $SHELL` 查看当前 shell 类型，然后搜索对应 shell 添加 PATH 的方法
56+
### 验证安装：打开新终端运行 `aptos help`
57+
- 应显示 CLI 可用命令列表
58+
- 这是未来学习各命令用法的实用参考资料
59+
</Steps>
60+
61+
<Callout type="info" emoji="ℹ️">
62+
如需更新 Aptos CLI 至最新版本，可运行 `aptos update`
63+
</Callout>
64+
65+
# 通过预编译二进制文件安装（备用方法）
66+
67+
<Steps>
68+
### 访问 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli&expanded=true)
69+
### 点击最新版本的 "Assets" 可展开菜单查看预编译文件
70+
### 下载 macOS 版 zip 文件
71+
1. 文件名类似：`aptos-cli-<version>-macOS-x86_64.zip` 或 `aptos-cli-<version>-macOS-arm64.zip`
72+
2. 确保选择与电脑架构匹配的文件（Intel/AMD 选 x86_64，ARM 选 arm64）
73+
3. 下载时可能需要忽略"可疑文件"警告
74+
### 解压下载的文件
75+
### 将解压后的 Aptos 二进制文件移至目标文件夹
76+
### 打开终端并导航至目标文件夹
77+
### 运行 `chmod +x ~/aptos` 赋予可执行权限
78+
### 验证安装：运行 `~/aptos help`
79+
应显示所有 CLI 命令的使用说明，这些说明对后续使用很有帮助。
80+
### （可选）将 Aptos CLI 添加到 PATH 环境变量的某个文件夹中，或直接添加到 PATH 可能会很有帮助。
81+
- 将文件夹添加到 PATH 的步骤取决于所使用的 shell。
82+
- 你可以运行 `echo $SHELL` 来打印你机器的默认 shell，然后搜索针对该 shell 添加文件夹到 PATH 的具体步骤。
83+
84+
</Steps>
85+
86+
<Callout type="info" emoji="ℹ️">
87+
使用预编译二进制文件方式时，你可以通过删除现有安装，然后重新按照安装步骤操作来更新 Aptos CLI。
88+
</Callout>

‎apps/nextra/pages/zh/build/cli/install-cli/install-cli-specific-version.mdx‎

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,30 @@ import { Steps } from 'nextra/components'
22

33
# 安装特定版本的 Aptos CLI（高级）
44

5-
如果你需要特定版本的 Aptos CLI，你可以直接从 Aptos 源代码构建它。这种安装方法主要用于与 Devnet 上的特定功能交互，这些功能可能尚未进入 Testnet / Mainnet。如果你运行的架构与现有版本/预编译二进制文件不兼容，你可能也需要按照这些步骤操作。
5+
如果需要特定版本的 Aptos CLI，可以直接从 Aptos 源代码构建。此安装方法主要用于与 Devnet 上的特定功能交互，这些功能可能尚未发布到 Testnet/Mainnet。如果您运行的架构与现有发布版本/预编译二进制文件不兼容，也可以按照以下步骤操作。
66

7-
如果你不需要这种高级方法，你可以在[这里](../../cli.mdx)找到普通的安装步骤。
7+
如果不需要此高级方法，可以在[这里](../../cli.mdx)找到常规安装步骤。
88

9-
## 在 macOS / Linux 上安装
9+
## 在 macOS/Linux 上安装
1010

1111
<Steps>
12-
### 按照[从源代码构建 Aptos](../../../network/nodes/building-from-source.mdx) 的步骤操作。
13-
### 按照[此页面](https://doc.rust-lang.org/cargo/getting-started/installation.html#install-rust-and-cargo)上的步骤确保已安装 `cargo`。
12+
### 按照[从源代码构建 Aptos](../../../network/nodes/building-from-source.mdx)的步骤操作。
13+
### 按照[此页面](https://doc.rust-lang.org/cargo/getting-started/installation.html#install-rust-and-cargo)的步骤确保已安装 `cargo`。
1414
### 构建 CLI 工具：`cargo build --package aptos --profile cli`。
15-
二进制文件将位于 `target/cli/aptos`。
16-
### (可选) 将此可执行文件移动到 PATH 中的某个位置。
17-
### 通过运行 `target/cli/aptos help` 验证安装是否成功。
18-
这些帮助说明也可以作为特定命令的详细指南。
15+
构建后的二进制文件将位于 `target/cli/aptos`。
16+
### （可选）将此可执行文件移动到 PATH 环境变量包含的目录。
17+
### 运行 `target/cli/aptos help` 验证安装是否成功。
18+
这些帮助说明也作为特定命令的详细指南非常有用。
1919
</Steps>
2020

2121
## 在 Windows 上安装
2222

2323
<Steps>
24-
### 按照[这里](../../../network/nodes/building-from-source.mdx)的步骤从源代码构建 Aptos。
25-
### 按照[此页面](https://doc.rust-lang.org/cargo/getting-started/installation.html#install-rust-and-cargo)上的步骤确保已安装 `cargo`。
24+
### 按照[此文档](../../../network/nodes/building-from-source.mdx)的步骤从源代码构建 Aptos。
25+
### 确保已安装 `cargo`，可参考[此页面](https://doc.rust-lang.org/cargo/getting-started/installation.html#install-rust-and-cargo)的安装步骤。
2626
### 构建 CLI 工具：`cargo build --package aptos --profile cli`。
27-
二进制文件将位于 `target\cli\aptos.exe`。
28-
### (可选) 将此可执行文件移动到 PATH 中的某个位置。
29-
### 通过运行 `target\cli\aptos.exe help` 验证安装是否成功。
30-
这些帮助说明也可以作为特定命令的详细指南。
31-
</Steps>
27+
构建后的二进制文件将位于 `target\cli\aptos.exe`。
28+
### （可选）将此可执行文件移动到 PATH 环境变量包含的目录中。
29+
### 运行 `target\cli\aptos.exe help` 验证安装是否成功。
30+
这些帮助说明也可作为特定命令的详细使用指南。
31+
</Steps>

‎apps/nextra/pages/zh/build/cli/install-cli/install-cli-windows.mdx‎

Lines changed: 38 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -2,63 +2,67 @@ import { Callout, Steps } from 'nextra/components'
22

33
# 在 Windows 上安装 Aptos CLI
44

5-
对于 Windows，安装 Aptos CLI 工具最简单的方法是通过 Python 脚本。如果这种方法不起作用，你也可以通过预编译二进制文件手动安装。不建议使用预编译二进制文件的方法，因为更新过程非常手动。
5+
对于 Windows 系统，安装 Aptos CLI 工具最简单的方式是通过 PowerShell 脚本。如果该方法不可行，您也可以通过预编译二进制文件手动安装。通常不建议使用预编译二进制文件方式，因为更新过程非常手动化。
66

7-
# 通过 Python 脚本安装
7+
# 通过 PowerShell 脚本安装
88
<Steps>
9-
### 通过运行 `python3 --version` 确保已安装 Python 3.6+
10-
11-
如果未安装 python3，你可以在 [python.org](http://python.org) 找到安装说明。
12-
139
### 在 PowerShell 中运行安装脚本：
1410

1511
```powershell filename="Terminal"
16-
Invoke-WebRequest -Uri "https://aptos.dev/scripts/install_cli.py" -OutFile "$env:TEMP\install_cli.py"; python "$env:TEMP\install_cli.py"
12+
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; iwr https://aptos.dev/scripts/install_cli.ps1 | iex
1713
```
1814

19-
<Callout type="warning">
20-
如果你收到错误 `ModuleNotFoundError: No module named packaging`，你可以通过运行 `pip3 install packaging` 然后重复此步骤来安装 `packaging`。
21-
</Callout>
22-
23-
你应该在终端中看到说明"Execute the following command to update your PATH:"。
24-
### 从终端复制并运行命令以更新你的 PATH。
25-
26-
它应该类似于 `setx PATH "%PATH%;C:\Users\<your_account_name>\.aptoscli\bin"`。
27-
28-
### 通过打开新终端并运行 `aptos help` 来验证脚本是否已安装。
29-
- 你应该看到可以使用 CLI 运行的命令列表。
30-
- 将来，这是一个有用的资源，可以了解每个命令的具体工作方式。
15+
### 打开新的终端并运行 `aptos help` 验证安装是否成功。
16+
- 您应该能看到 CLI 可运行的命令列表。
17+
- 这是未来学习每个命令具体用法的有用资源。
3118
</Steps>
3219

3320
<Callout type="info" emoji="ℹ️">
34-
如果你想通过脚本将 Aptos CLI 更新到最新版本，可以运行 `aptos update`。
21+
如需通过脚本将 Aptos CLI 更新至最新版本，可以运行 `aptos update`。
22+
</Callout>
23+
24+
# 通过包管理器安装（可选）
25+
26+
<Callout type="info">
27+
通过包管理器安装 Aptos 后，未来请通过相同包管理器进行更新。
3528
</Callout>
3629

37-
# 通过预编译二进制文件安装（备用方法）
30+
### 如果已安装 [Scoop](https://scoop.sh/)，可运行以下命令安装 Aptos CLI：
31+
32+
```powershell filename="Terminal"
33+
scoop install https://aptos.dev/scoop/aptos.json
34+
```
35+
### 如果已安装 [Chocolatey](https://chocolatey.org/)，可运行以下命令安装 Aptos CLI：
36+
37+
```powershell filename="Terminal"
38+
choco install aptos
39+
```
40+
41+
# 通过预编译二进制文件安装（备用方案）
3842

3943
<Steps>
40-
### 转到 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli&expanded=true)。
41-
### 展开"Assets"以查看预编译二进制文件。
42-
### 下载 Windows 的 zip 文件。
43-
- 它的名称类似：`aptos-cli-<version>-Windows-x86_64.zip`
44-
- 下载时你可能需要忽略这是可疑文件的警告。
44+
### 访问 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli&expanded=true)。
45+
### 展开 "Assets" 查看预编译二进制文件。
46+
### 下载适用于 Windows 的 zip 文件。
47+
- 文件名格式类似：`aptos-cli-<version>-Windows-x86_64.zip`
48+
- 下载时可能需要忽略"可疑文件"警告。
4549
### 解压下载的文件。
46-
- 将文件移动到你将来想要调用 `aptos` 的任何文件夹中。
47-
### 右键单击，然后复制可执行文件的路径。
50+
- 将文件移动至您未来希望调用 `aptos` 的任意文件夹。
51+
### 右键点击，然后复制可执行文件路径。
4852
例如 `C:\Users\<username>\Downloads\aptos-cli-3.1.0-Windows-x86_64\aptos.exe`。
4953
<Callout type="info" emoji="ℹ️">
50-
你可能想将此路径添加到 PATH 环境变量中，以简化将来调用 Aptos CLI。
54+
建议将此路径添加至 PATH 环境变量，以便后续简化 Aptos CLI 调用。
5155
</Callout>
5256
### 通过开始菜单打开 PowerShell。
53-
### 通过运行 `help` 命令验证安装。
54-
使用你之前复制的路径调用 Aptos CLI。
57+
### 运行 `help` 命令验证安装。
58+
使用之前复制的路径调用 Aptos CLI。
5559
例如 `C:\Users\<username>\Downloads\aptos-cli-3.1.0-Windows-x86_64\aptos.exe help`。
5660
</Steps>
5761

5862
<Callout type="info" emoji="ℹ️">
59-
使用预编译二进制文件安装时，你可以通过删除现有安装，然后再次按照安装步骤操作来更新 Aptos CLI。
63+
使用预编译二进制文件安装时，如需更新 Aptos CLI，请删除现有安装后重新执行安装步骤。
6064
</Callout>
6165

6266
<Callout type="warning">
63-
如果以上两种方法都不起作用，你将不得不按照这些步骤从源代码构建 CLI：[安装特定版本的 Aptos CLI (高级)](install-cli-specific-version.mdx)
64-
</Callout>
67+
如果以上方法均不奏效，您需要通过源码构建 CLI（请遵循按照以下步骤操作：[安装特定版本的 Aptos CLI（高级）](install-cli-specific-version.mdx)
68+
</Callout>

0 commit comments

Comments
 (0)