Установка зависимостей

Руководство по настройке локальной среды разработки Solana. Узнайте, как установить Rust, Solana CLI и Anchor Framework на Windows (WSL), Linux и Mac. Используйте это руководство, если вы предпочитаете устанавливать каждую зависимость отдельно или если быстрая установка не удалась по какой-либо причине.

Предварительные требования

Установите Rust

Разработчики создают программы для Solana, используя язык программирования Rust.

  1. Установите Rust с помощью rustup, введя следующую команду в терминале:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

После успешной установки вы увидите следующее сообщение:

  1. Перезагрузите переменную окружения PATH, чтобы включить каталог bin Cargo:
Terminal
$
. "$HOME/.cargo/env"
  1. Убедитесь, что установка прошла успешно.
Terminal
$
rustc --version

Вы увидите вывод, похожий на следующий:

rustc 1.86.0 (05f9846f8 2025-03-31)

Установите Solana CLI

Solana CLI предоставляет все инструменты, необходимые для создания и развертывания программ Solana.

  1. Установите набор инструментов Solana CLI, используя официальную команду установки:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Вы можете заменить stable на тег релиза, соответствующий версии программного обеспечения вашего желаемого релиза (например, v2.0.3), или использовать одно из трёх символических названий каналов: stablebeta, или edge.

  1. Добавьте переменную окружения PATH

При первой установке Solana CLI вам может быть предложено добавить переменную окружения PATH. Для этого закройте и снова откройте терминал или выполните следующую команду в оболочке:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
  1. Обновите переменную окружения PATH

Если вы используете Linux или WSL, вам необходимо добавить бинарный файл Solana CLI в PATH, чтобы команда была доступна в вашем терминале. Для этого выполните следующие шаги:

a. Проверьте, какую оболочку вы используете:

Terminal
$
echo $SHELL
  • Если вывод содержит /bash, используйте .bashrc.
  • Если вывод содержит /zsh, используйте .zshrc.

б. Выполните соответствующую команду в зависимости от используемой оболочки.

Для Bash (bashrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

Для Zsh (zshrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc
  1. Перезапустите терминал или выполните следующую команду, чтобы обновить сеанс терминала:
Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh
  1. Убедитесь, что установка прошла успешно, проверив версию Solana CLI:
Terminal
$
solana --version

Вы увидите вывод, похожий на следующий:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Вы можете просмотреть все доступные версии в репозитории Agave на Github. Agave — это клиент валидатора от Anza, ранее известного как клиент валидатора Solana Labs.

  1. Обновите Solana CLI до последней версии, если необходимо (опционально)
Terminal
$
agave-install update

Установите Anchor CLI

Anchor — это фреймворк для разработки программ на Solana. Фреймворк Anchor использует макросы Rust, чтобы упростить процесс написания программ для Solana.

Предварительные требования

Тестовый файл проекта Anchor по умолчанию (TypeScript), созданный с помощью команды anchor init, требует наличия Node.js и Yarn. (Шаблон теста на Rust доступен с использованием anchor init --test-template rust.)

Установка

Вы можете установить Anchor CLI и инструменты двумя способами:

  • Anchor Version Manager (AVM) — рекомендуемый способ установки
  • Без AVM — установка напрямую из GitHub

Anchor Version Manager (AVM) позволяет устанавливать и управлять различными версиями Anchor на вашей системе, а также легко обновлять версии Anchor в будущем. Чтобы установить Anchor с помощью AVM, выполните следующие шаги:

  1. Установите AVM с помощью следующей команды:
Terminal
$
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. Убедитесь, что AVM успешно установлен:
Terminal
$
avm --version
  1. Установите Anchor CLI с помощью AVM:

Чтобы установить последнюю версию:

Terminal
$
avm install latest
$
avm use latest

Чтобы установить конкретную версию, укажите номер версии:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

При установке Anchor CLI на Linux или WSL вы можете столкнуться с этой ошибкой:

error: could not exec the linker cc = note: Permission denied (os error 13)

Если вы видите это сообщение об ошибке, выполните следующие действия:

  1. Установите зависимости, перечисленные в разделе Linux в начале этой страницы.
  2. Повторите попытку установки Anchor CLI.
  1. Убедитесь, что установка прошла успешно, проверив версию Anchor CLI:
Terminal
$
anchor --version

Вы увидите вывод, похожий на следующий:

anchor-cli 0.31.1

Не забудьте выполнить команду avm use, чтобы указать версию Anchor CLI, которая будет использоваться на вашей системе.

  • Если вы установили версию latest, выполните avm use latest.
  • Если вы установили версию 0.30.1, выполните avm use 0.30.1.

Настройка инструментов ИИ для разработки на Solana

В этом разделе описана настройка дополнительных инструментов ИИ, которые вы можете использовать для ускорения разработки на Solana.

ИнструментОписаниеСсылка
MCPMCP-сервер, к которому вы можете подключиться с помощью курсора для улучшения разработки с поддержкой ИИ на Solana.https://mcp.solana.com/
LLMs.txtОптимизированная документация для LLM, которую вы можете использовать для обучения LLM на документации Solana.https://solana.com/llms.txt

Is this page helpful?