如何在macOS、Linux 和 Windows 上安装基于 Polkadot SDK 依赖项

原文作者：PaperMoon团队

本指南提供了在 macOS、Linux 和 Windows 上安装基于 Polkadot SDK 链所需依赖的分步说明。

macOS

你可以在 Intel 或 Apple M1 处理器 的 macOS 电脑上安装 Rust 并搭建 Substrate 开发环境。

开始之前

在 macOS 上安装 Rust 并配置开发环境前，请确认你的电脑满足以下基本要求：
    •    操作系统版本：macOS 10.7 Lion 或更高
    •    处理器主频：至少 2 GHz（推荐 3 GHz）
    •    内存：至少 8 GB RAM（推荐 16 GB）
    •    存储空间：至少 10 GB 可用空间
    •    宽带互联网连接

安装 Homebrew

在大多数情况下，推荐使用 Homebrew 来管理 macOS 上的软件包。如果你的电脑尚未安装 Homebrew，请先完成安装。

安装步骤：
    1.    打开 Terminal（终端）
    2.    运行以下命令下载并安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

    3.    通过以下命令验证 Homebrew 是否安装成功：

brew --version

命令输出示例如下：

Homebrew 4.3.15

Apple Silicon 支持说明

在开始构建之前，必须先安装 Protobuf。运行以下命令：

brew install protobuf

安装所需软件包与 Rust

由于区块链需要标准密码学能力来支持公私钥生成与交易签名验证，你还需要安装提供密码学支持的软件包，例如 openssl。

安装步骤：
    1.    打开 Terminal
    2.    确保 Homebrew 为最新版本：

brew update

    3.    安装 openssl：

brew install openssl

    4.    下载并运行 rustup 安装程序以安装 Rust：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

按照提示完成默认安装。
    5.    更新当前 shell 以加载 Cargo：

source ~/.cargo/env

    6.    将 Rust 工具链配置为默认使用最新稳定版：

rustup default stable
rustup update
rustup target add wasm32-unknown-unknown
rustup component add rust-src

    7.    安装 cmake：

brew install cmake

Linux

Rust 支持大多数 Linux 发行版。根据你所使用的发行版和版本，可能需要额外安装一些软件依赖。一般来说，你的开发环境需要包含链接器或 C 兼容编译器（如 clang），以及合适的 IDE。

开始之前

请查阅你所使用的操作系统文档，了解已安装的软件包以及如何安装缺失依赖。

例如，在 Ubuntu 上，可以使用 apt 安装 build-essential：

sudo apt install build-essential

在安装 Rust 之前，至少需要以下软件包：

clang curl git make

同时，由于区块链需要标准密码学能力，你还需要安装提供密码学支持的库，如 libssl-dev 或 openssl-devel。

安装所需软件包与 Rust

安装步骤：
    1.    打开终端
    2.    使用发行版对应的包管理器检查已安装的软件包
    3.    安装缺失的依赖（以下以 Ubuntu / Debian 为例）：

sudo apt install --assume-yes git clang curl libssl-dev protobuf-compiler

请注意：不同发行版使用的包管理器和软件包名称可能不同。
上述命令适用于多种常见 Linux 发行版，包括 Debian、Linux Mint、MX Linux 和 Elementary OS。

    4.    下载并运行 rustup 安装程序：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

    5.    加载 Cargo 到当前 shell：

source $HOME/.cargo/env

    6.    验证 Rust 安装：

rustc --version

    7.    配置 Rust 工具链：

rustup default stable
rustup update
rustup target add wasm32-unknown-unknown
rustup component add rust-src

Windows（WSL）

通常，macOS 或 Linux 这样的 UNIX 系统更适合用于构建基于 Substrate 的区块链。

如果你使用的是 Microsoft Windows，可以通过 Windows Subsystem for Linux（WSL） 来模拟 UNIX 开发环境，从而构建 Substrate 区块链。

开始之前

请确认以下条件：
    •    操作系统要求
    •    Windows 10（2004 版本及以上）或 Windows 11
    •    Windows Server 2019 或更高版本
    •    稳定的网络连接
    •    可以访问终端（PowerShell 或 Command Prompt）

设置 Windows Subsystem for Linux（WSL）

WSL 允许你在 Windows 上运行 Linux 环境，其优势在于可以直接使用 Substrate 文档中的所有命令（如 ls、ps），无需修改。

安装步骤：
    1.    检查 Windows 版本：
    •    Windows 10（2004 / Build 19041 及以上）或 Windows 11 默认支持 WSL
    •    较老版本请参考官方 WSL 手动安装文档
    2.    从开始菜单中选择 Windows PowerShell 或 Command Prompt
    3.    右键 → 以管理员身份运行
    4.    执行以下命令：

wsl --install

该命令将：
    •    启用 WSL 2 组件
    •    下载最新 Linux 内核
    •    默认安装 Ubuntu 发行版

    5.    查看可用的 Linux 发行版：

wsl --list --online

    6.    关闭终端并 重启电脑

重启后，Linux 发行版的安装可能还需要几分钟时间完成。

在 WSL 中安装所需软件包与 Rust
    1.    打开 Ubuntu
    2.    创建 UNIX 用户名与密码
    3.    更新系统：

sudo apt update

    4.    安装所需依赖：

sudo apt install --assume-yes git clang curl libssl-dev llvm libudev-dev make protobuf-compiler

    5.    安装 Rust：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

    6.    加载 Cargo：

source ~/.cargo/env

    7.    验证 Rust 安装：

rustc --version

    8.    配置 Rust 工具链：

rustup default stable
rustup update
rustup target add wasm32-unknown-unknown
rustup component add rust-src

验证安装

通过以下命令验证开发环境配置是否正确：

rustup show

示例输出：

active toolchain
----------------
name: stable-aarch64-apple-darwin
active because: it's the default toolchain
installed targets:
 aarch64-apple-darwin
 wasm32-unknown-unknown

原文链接：https://docs.polkadot.com/develop/parachains/install-polkadot-sdk/