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.
- 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:
$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:
- 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:
$. "$HOME/.cargo/env"
- Xác minh rằng việc cài đặt đã thành công.
$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.
- 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:
$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
.
- 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"
- 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:
$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
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Đối với Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Khởi động lại terminal của bạn hoặc chạy lệnh sau để làm mới phiên terminal:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- 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:
$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.
- Cập nhật Solana CLI lên phiên bản mới nhất, khi cần (Tùy chọn)
$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:
- Cài đặt AVM với lệnh sau:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Xác nhận rằng AVM đã được cài đặt thành công:
$avm --version
- Cài đặt Anchor CLI sử dụng AVM:
Để cài đặt phiên bản mới nhất:
$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:
$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:
- Cài đặt các phụ thuộc được liệt kê trong phần Linux ở đầu trang này.
- Thử cài đặt lại Anchor CLI.
- 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:
$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ạyavm use latest
. - Nếu bạn đã cài đặt phiên bản
0.30.1
, hãy chạyavm 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 |
---|---|---|
MCP | Má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.txt | Tà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?