Cài đặt các phụ thuộc

Hướng dẫn thiết lập môi trường phát triển Solana trên máy tính của bạn. Tìm hiểu cách cài đặt Rust, Solana CLI và Anchor Framework trên Windows (WSL), Linux và Mac. Sử dụng hướng dẫn này nếu bạn muốn cài đặt từng phụ thuộc riêng lẻ, hoặc nếu cài đặt nhanh không thành công vì bất kỳ lý do nào.

Điều kiện tiên quyết

Cài đặt Rust

Các nhà phát triển xây dựng chương trình Solana bằng ngôn ngữ lập trình Rust.

  1. Cài đặt Rust bằng cách sử dụng rustup bằng cách nhập lệnh sau vào terminal của bạn:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Sau khi cài đặt thành công, bạn sẽ thấy thông báo sau:

  1. Tải lại biến môi trường PATH của bạn để bao gồm thư mục bin của Cargo:
Terminal
$
. "$HOME/.cargo/env"
  1. Xác minh rằng việc cài đặt đã thành công.
Terminal
$
rustc --version

Bạn sẽ thấy kết quả như sau:

rustc 1.86.0 (05f9846f8 2025-03-31)

Cài đặt Solana CLI

Solana CLI cung cấp tất cả các công cụ cần thiết để xây dựng và triển khai các chương trình Solana.

  1. Cài đặt bộ công cụ Solana CLI bằng cách sử dụng lệnh cài đặt chính thức:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Bạn có thể thay thế stable bằng thẻ phiên bản phù hợp với phiên bản phần mềm của bản phát hành mong muốn (ví dụ: v2.0.3), hoặc sử dụng một trong ba tên kênh tượng trưng: stable, beta, hoặc edge.

  1. Thêm biến môi trường PATH

Lần đầu cài đặt Solana CLI, có thể bạn sẽ được nhắc thêm biến môi trường PATH. Để làm điều này, hãy đóng và mở lại terminal của bạn hoặc chạy lệnh sau trong shell của bạn:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
  1. Cập nhật biến môi trường PATH của bạn

Nếu bạn đang sử dụng Linux hoặc WSL, bạn phải thêm Solana CLI binary vào PATH của bạn để lệnh có sẵn trong terminal. Để làm điều này, hãy làm theo các bước dưới đây:

a. Kiểm tra shell bạn đang sử dụng:

Terminal
$
echo $SHELL
  • Nếu đầu ra chứa /bash, hãy sử dụng .bashrc.
  • Nếu đầu ra chứa /zsh, hãy sử dụng .zshrc.

b. Chạy lệnh thích hợp, dựa trên shell của bạn.

Đối với Bash (bashrc):

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

Đối với Zsh (zshrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc
  1. Khởi động lại terminal của bạn hoặc chạy lệnh sau để làm mới phiên terminal:
Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh
  1. Xác minh rằng việc cài đặt đã thành công bằng cách kiểm tra phiên bản Solana CLI:
Terminal
$
solana --version

Bạn sẽ thấy kết quả như sau:

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

Bạn có thể xem tất cả các phiên bản có sẵn trên Agave Github repo. Agave là validator client từ Anza, trước đây được biết đến là Solana Labs validator client.

  1. Cập nhật Solana CLI lên phiên bản mới nhất, khi cần (Tùy chọn)
Terminal
$
agave-install update

Cài đặt Anchor CLI

Anchor là một framework để phát triển các chương trình Solana. Framework Anchor sử dụng các macro Rust để đơn giản hóa quá trình viết các chương trình Solana.

Điều kiện tiên quyết

Tệp kiểm thử mặc định của dự án Anchor (TypeScript) được tạo bằng lệnh anchor init yêu cầu Node.js và Yarn. (Mẫu kiểm thử Rust có sẵn bằng cách sử dụng anchor init --test-template rust)

Cài đặt

Bạn có thể cài đặt Anchor CLI và các công cụ theo hai cách:

  • Anchor Version Manager (AVM) — Phương pháp cài đặt được khuyến nghị
  • Không dùng AVM — Cài đặt trực tiếp từ GitHub

Anchor Version Manager (AVM) cho phép bạn cài đặt và quản lý các phiên bản Anchor khác nhau trên hệ thống của bạn và dễ dàng cập nhật phiên bản Anchor trong tương lai. Để cài đặt Anchor sử dụng AVM, hãy làm theo các bước sau:

  1. Cài đặt AVM với lệnh sau:
Terminal
$
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. Xác nhận rằng AVM đã được cài đặt thành công:
Terminal
$
avm --version
  1. Cài đặt Anchor CLI sử dụng AVM:

Để cài đặt phiên bản mới nhất:

Terminal
$
avm install latest
$
avm use latest

Để cài đặt một phiên bản cụ thể, hãy chỉ định số phiên bản:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Khi cài đặt Anchor CLI trên Linux hoặc WSL, bạn có thể gặp lỗi này:

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

Nếu bạn thấy thông báo lỗi này, hãy làm theo các bước sau:

  1. Cài đặt các phụ thuộc được liệt kê trong phần Linux ở đầu trang này.
  2. Thử cài đặt lại Anchor CLI.
  1. Xác minh rằng việc cài đặt đã thành công bằng cách kiểm tra phiên bản Anchor CLI:
Terminal
$
anchor --version

Bạn sẽ thấy kết quả như sau:

anchor-cli 0.31.1

Đừng quên chạy lệnh avm use để khai báo phiên bản Anchor CLI sẽ chạy trên hệ thống của bạn.

  • Nếu bạn đã cài đặt phiên bản latest, hãy chạy avm use latest.
  • Nếu bạn đã cài đặt phiên bản 0.30.1, hãy chạy avm use 0.30.1.

Thiết lập công cụ AI cho phát triển Solana

Phần này mô tả chi tiết về việc thiết lập công cụ AI tùy chọn mà bạn có thể sử dụng để đẩy nhanh quá trình phát triển Solana của mình.

Công cụMô tảLiên kết
MCPMáy chủ MCP mà bạn có thể kết nối với cursor để cải thiện phát triển Solana có hỗ trợ AI.https://mcp.solana.com/
LLMs.txtTài liệu được tối ưu hóa cho LLM mà bạn có thể sử dụng để huấn luyện LLM trên tài liệu Solana.https://solana.com/llms.txt

Is this page helpful?

Mục lục

Chỉnh sửa trang