Feature Flags & cfg

Usa features de Cargo y #[cfg(feature = ...)] para controlar logs de depuración, instrucciones solo para desarrollo y código específico del clúster en programas de Anchor.

Receta

[features]
default = []
debug-log = []
devnet-only = []

#[cfg(feature = "debug-log")]
msg!("debug");

Cuándo usar esto: Necesitas diferentes compilaciones para desarrollo vs mainnet o diagnósticos opcionales.

Ejemplo Funcional

Limita la instrucción, no el módulo #[program]. Dos módulos con el mismo nombre seleccionados por cfg son frágiles y fáciles de hacer mal; un solo módulo con un manejador limitado por cfg compila limpiamente y mantiene una forma de IDL por compilación.

use anchor_lang::prelude::*;
 
declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
#[program]
pub mod my_program {
    use super::*;
 
    pub fn settle(_ctx: Context<Settle>) -> Result<()> {
        Ok(())
    }
 
    /// Compilado completamente fuera a menos que se use `--features devnet-only`.
    #[cfg(feature = "devnet-only")]
    pub fn airdrop_test_tokens(_ctx: Context<Airdrop>) -> Result<()> {
        Ok(())
    }
}
 
#[derive(Accounts)]
pub struct Settle<'info> {
    pub authority: Signer<'info>,
}
 
#[cfg(feature = "devnet-only")]
#[derive(Accounts)]
pub struct Airdrop<'info> {
    pub authority: Signer<'info>,
}

Lo que esto demuestra:

• Las features controlan la inclusión en tiempo de compilación
• Binario de mainnet más pequeño sin instrucciones de desarrollo
• Limita manejadores y sus structs Accounts juntos, no el módulo #[program]
• La compilación de devnet emite un IDL diferente - envía la compilación de features por defecto a mainnet
• Documenta las features en README

Análisis Profundo

Advertencia de Anchor

Dividir módulos #[program] por cfg cambia el IDL entre compilaciones. Prefiere crates de desarrollo separados o instrucciones detrás de claves de administrador en lugar de enviar instrucciones de desarrollo a mainnet.

Patrón de feature de clúster

Usa constantes en Anchor.toml / scripts de compilación en lugar de múltiples módulos #[program] cuando sea posible.

Errores Comunes

• IDL diferente por conjunto de features - Confusión del cliente. Solución: Un perfil de lanzamiento para mainnet.
• Habilitar accidentalmente devnet-only en mainnet - Superficie de ataque adicional. Solución: CI prohíbe la combinación de features.
• cfg en structs de cuenta - Desviación del layout del IDL. Solución: Mantén el layout de la cuenta estable entre compilaciones.
• Feature de logs de depuración dejada activada - Desperdicio de CU. Solución: Features por defecto vacías.
• Error de dos módulos #[program] - Errores de compilación. Solución: Un solo módulo de programa por compilación.

Alternativas

Preguntas Frecuentes

Relacionado

• Logging & CU Cost - logs de depuración
• Program Upgrades - lanzamientos
• Making Programs Immutable - despliegue final

Versiones de Stack: 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.

Y29kZWd1aWRlcy5pb3xjZ2lvMjkwfDIwMjYwNw