Configuración del Editor y rust-analyzer

Configura VS Code (o Cursor) con rust-analyzer para una navegación rápida, expansión de macros y ejecuciones de pruebas en programas de Solana/Anchor.

Receta

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

rustup component add rust-analyzer
code --install-extension rust-lang.rust-analyzer

Esenciales de .vscode/settings.json:

{
  "rust-analyzer.cargo.extraEnv": {},
  "rust-analyzer.check.command": "clippy",
  "editor.formatOnSave": true
}

Cuándo usar esto:

• Saltar a la definición entre módulos #[program] de Anchor.
• Errores en línea antes de los ciclos de compilación de anchor build.
• Renombrar cuentas e instrucciones de forma segura.
• Ejecutar cargo test para analizadores fuera de la cadena junto a los programas.

Ejemplo de Trabajo

# Fijar Rust en la raíz del repositorio
cat > rust-toolchain.toml <<'EOF'
[toolchain]
channel = "1.91.1"
components = ["rustfmt", "clippy", "rust-analyzer"]
EOF
 
rustup show active-toolchain
 
# Abrir espacio de trabajo de Anchor
cd my_anchor_program
code .
 
# En el editor: abrir programs/my_program/src/lib.rs
# rust-analyzer debería indexar después de que "cargo metadata" se complete

settings.json del espacio de trabajo:

{
  "rust-analyzer.linkedProjects": ["programs/my_program/Cargo.toml"],
  "rust-analyzer.cargo.buildScripts.enable": true,
  "[rust]": {
    "editor.defaultFormatter": "rust-lang.rust-analyzer"
  }
}

Lo que esto demuestra:

• rust-toolchain.toml fija la versión 1.91.1 para la paridad del analizador y la CLI.
• linkedProjects ayuda a los monorepos donde la raíz puede no ser un crate de Rust.
• buildScripts.enable resuelve el código generado por el script de compilación de anchor-syn.

Análisis Profundo

Cómo Funciona

• rust-analyzer ejecuta cargo check al guardar para obtener retroalimentación rápida.
• Las macros procedurales (#[program], #[account]) requieren la salida del script de compilación.
• Los crates fuera de la cadena en tests/ o clients/ pueden ser miembros separados del espacio de trabajo.
• Formatea con rustfmt consistente con la CI de cargo fmt.

Extensiones Recomendadas

Notas de bash

# Reiniciar la caché del analizador cuando las macros fallan
rm -rf target/debug/incremental
cargo clean && anchor build

Trampas

• Analizador atascado en la herramienta incorrecta - conflicto entre estable y la versión fijada 1.91.1. Solución: confirmar rust-toolchain.toml; recargar ventana.
• Errores de macro en lib.rs - scripts de compilación no ejecutados. Solución: habilitar buildScripts; ejecutar anchor build una vez.
• Abrir la carpeta raíz incorrecta - abrir la raíz del espacio de trabajo de Anchor, no solo la subcarpeta programs/*. Solución: abrir la raíz del repositorio con Anchor.toml.
• División WSL vs Windows - analizador en ruta de Windows, cargo en WSL. Solución: abrir el proyecto completamente dentro del entorno remoto de WSL.
• target/ enorme para indexar - IDE lento. Solución: excluir target/ en la configuración del observador de archivos.

Alternativas

Preguntas Frecuentes

Relacionado

• Gestión de Versiones (agave-install / avm) - La fijación de Rust complementa la cadena de herramientas
• Construcción de Programas (cargo build-sbf) - bucle de compilación completo
• Descripción General de la Cadena de Herramientas - mapa de la pila
• Conceptos Básicos de Pruebas - flujo de trabajo de pruebas

Versiones de la pila: Esta página fue escrita 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.