Código de Sistemas Multiplataforma

Escreva código de sistemas portável com cfg, compilação condicional e crates de abstração de plataforma.

Receita

#[cfg(unix)]
fn home_dir() -> Option<std::path::PathBuf> {
    std::env::var_os("HOME").map(std::path::PathBuf::from)
}
 
#[cfg(windows)]
fn home_dir() -> Option<std::path::PathBuf> {
    std::env::var_os("USERPROFILE").map(std::path::PathBuf::from)
}

Quando usar isso: Ferramentas e bibliotecas que funcionam em Linux, macOS e Windows sem a necessidade de manter bases de código separadas.

Exemplo de Trabalho

use std::path::{Path, PathBuf};
 
#[cfg(unix)]
mod platform {
    use std::os::unix::fs::PermissionsExt;
    pub fn is_executable(meta: &std::fs::Metadata) -> bool {
        meta.permissions().mode() & 0o111 != 0
    }
}
 
#[cfg(windows)]
mod platform {
    pub fn is_executable(meta: &std::fs::Metadata) -> bool {
        meta.is_file() && meta.file_name().to_string_lossy().ends_with(".exe")
    }
}
 
pub fn find_in_path(name: &str) -> Option<PathBuf> {
    let path_var = std::env::var_os("PATH")?;
    for dir in std::env::split_paths(&path_var) {
        let candidate = dir.join(name);
        if candidate.is_file() {
            if let Ok(meta) = std::fs::metadata(&candidate) {
                if platform::is_executable(&meta) {
                    return Some(candidate);
                }
            }
        }
    }
    None
}

O que isso demonstra:

• cfg(unix) / cfg(windows) isolam o código da plataforma
• API compartilhada com implementações específicas da plataforma
• std::env::split_paths lida com diferenças de separador do PATH
• Verificações de executável diferem por sistema operacional

Mergulho Profundo

Atributos cfg

Crates de Abstração

Matriz de CI

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest, windows-latest]
    rust: [stable]

Armadilhas

• Suposições de strings de caminho - / codificado em hard break no Windows. Correção: Sempre use Path::join.
• Finais de linha - \r\n no Windows. Correção: Use linhas std::io::BufRead ou #[cfg(windows)] para remover.
• Caminhos sensíveis a maiúsculas/minúsculas - O padrão do macOS não diferencia maiúsculas de minúsculas. Correção: Normalize caminhos em testes; documente o comportamento.
• Derivação de recursos entre destinos - O código compila apenas no Linux. Correção: Requer CI em todos os três destinos de SO.
• Dependências exclusivas do Unix em recursos padrão - A compilação do Windows falha. Correção: Use cfg ou recursos opcionais.

Alternativas

FAQs

Relacionados

• Noções Básicas de Sistemas - uso de std portável
• Sinais e Controle de Processos - sinais específicos do SO
• libc e Syscalls - baixo nível específico da plataforma
• Melhores Práticas de Programação de Sistemas - checklist de portabilidade

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.