Descripción general de la cadena de herramientas

La cadena de herramientas de desarrollo de Solana integra Rust, los binarios del validador/CLI de Agave, las herramientas de plataforma (cargo build-sbf) y Anchor en un único canal de compilación y despliegue reproducible.

Receta

Tarjeta de receta de referencia rápida, lista para copiar y pegar.

rustc --version          # 1.91.1
solana --version         # solana-cli 3.0.10 (Agave 4.1.1)
anchor --version         # 0.32.1
cargo build-sbf --version

Cuándo usar esto:

• Para incorporar a un nuevo ingeniero a las versiones de herramientas esperadas.
• Para depurar fallos de compilación o despliegue del tipo "funciona en mi máquina".
• Para elegir entre flujos de trabajo de programas nativos de Rust o del framework Anchor.
• Para auditar si el CI coincide con los portátiles de los desarrolladores locales.

Ejemplo de trabajo

# Versiones principales para la pila fijada de esta guía
rustc --version
cargo --version
solana --version
agave-install --version
anchor --version
avm --version
 
# Flujo de trabajo típico del programa
anchor init my_program
cd my_program
anchor build
solana program deploy target/deploy/my_program.so

Lo que esto demuestra:

• Rust compila programas en cadena a sBPF ELF a través de cargo build-sbf.
• Agave proporciona los binarios solana, solana-keygen, spl-token y del validador.
• Anchor envuelve la estructura del programa, la generación de IDL y los entornos de prueba.

Análisis en profundidad

Cómo funciona

• Rust 1.91.1 es la cadena de herramientas de lenguaje para programas y muchos servicios fuera de cadena.
• Agave 4.1.1 es el cliente validador; Solana CLI 3.0.10 es el paquete de binarios para el operador.
• cargo build-sbf compila cruzadamente para el objetivo sBPF de Solana con sysroots específicos de la plataforma.
• Anchor 0.32.1 proporciona macros, validación de cuentas, IDL y generación de código de cliente TypeScript.

Mapa de la cadena de herramientas

Notas de bash

# Verificar las herramientas de plataforma en PATH
which cargo-build-sbf
ls "$(dirname $(which solana))"/cargo-build-sbf

Errores comunes

• Mezcla de Solana 1.x y Agave 4.x - los scripts de instalación heredados extraen cadenas de herramientas antiguas. Solución: usar exclusivamente el canal agave-install 4.1.1.
• Deriva global de Anchor - múltiples proyectos necesitan diferentes versiones de Anchor. Solución: avm use 0.32.1 por repositorio con Anchor.toml.
• Herramientas de plataforma faltantes - cargo build-sbf no encontrado después de una instalación parcial. Solución: reinstalar el paquete de Agave; verificar PATH.
• Confusión entre cliente Node y CLI - @solana/kit no reemplaza solana program deploy. Solución: CLI para operaciones, kit para lecturas/escrituras de aplicaciones.
• Rust nightly para programas - el objetivo en cadena espera una cadena de herramientas estable. Solución: permanecer en la versión estable 1.91.1 a menos que la documentación requiera explícitamente nightly.

Alternativas

Preguntas frecuentes

Relacionado

• Gestión de versiones (agave-install / avm) - fijar versiones
• Compilación de programas (cargo build-sbf) - canal de compilación
• Configuración del editor y rust-analyzer - bucle IDE
• Conceptos básicos de Solana CLI - configuración de la CLI

Versiones de la pila: Esta página se escribió para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 y LiteSVM 0.6.x.