CSV no Excel em português: ponto e vírgula, acentos e zeros à esquerda

Os três problemas de sempre

• Tudo numa coluna só: o arquivo usa vírgula, e o Excel em português espera ponto e vírgula. O separador segue a configuração regional do sistema, não o arquivo.
• Acentos quebrados (João no lugar de João): o arquivo está em UTF-8 sem BOM, e o Excel o lê como Windows-1252.
• Números errados: 1.5 vira data ou texto, e CEPs como 01310100 perdem o zero à esquerda.

O conversor de JSON para CSV permite escolher o separador e gera o arquivo com BOM. O conversor de CSV para JSON detecta o separador sozinho.

Gerar CSV para o Excel em JavaScript

Três ajustes resolvem: ponto e vírgula como separador, vírgula nos números decimais e o BOM (\uFEFF) no começo. Campos com ponto e vírgula, aspas ou quebra de linha vão entre aspas, com as aspas internas duplicadas.

// Monta um CSV que o Excel em português abre certo: ponto e vírgula, vírgula
// decimal e BOM para reconhecer o UTF-8
function csvParaExcel(linhas) {
  const colunas = Object.keys(linhas[0]);
  const celula = (v) => {
    const s = v == null ? '' : typeof v === 'number' ? String(v).replace('.', ',') : String(v);
    return /[;"\r\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
  };
  const texto = [colunas, ...linhas.map((l) => colunas.map((c) => l[c]))]
    .map((campos) => campos.map(celula).join(';'))
    .join('\r\n');
  return '' + texto;
}

Ler e escrever em Python

O módulo csv cuida das aspas. A codificação utf-8-sig escreve o BOM na gravação e o ignora na leitura, e newline="" evita linhas em branco extras no Windows.

import csv


def ler_csv_excel(caminho: str) -> list[dict]:
    # utf-8-sig ignora o BOM que o Excel grava no começo do arquivo
    with open(caminho, encoding="utf-8-sig", newline="") as f:
        return list(csv.DictReader(f, delimiter=";"))


def escrever_csv_excel(caminho: str, linhas: list[dict]) -> None:
    with open(caminho, "w", encoding="utf-8-sig", newline="") as f:
        w = csv.DictWriter(f, fieldnames=list(linhas[0]), delimiter=";")
        w.writeheader()
        w.writerows(linhas)

Ler em PHP

O fgetcsv não pula o BOM sozinho, então o exemplo confere os três primeiros bytes. O último argumento vazio desliga o caractere de escape próprio do PHP, que não faz parte do padrão CSV (e passá-lo explicitamente evita o aviso de depreciação no PHP 8.4).

<?php
function lerCsvExcel(string $caminho): array
{
    $f = fopen($caminho, 'r');
    if (fread($f, 3) !== "\xEF\xBB\xBF") {
        rewind($f); // não tinha BOM: volta ao começo
    }
    $cabecalho = fgetcsv($f, null, ';', '"', '');
    $linhas = [];
    while (($campos = fgetcsv($f, null, ';', '"', '')) !== false) {
        if ($campos !== [null]) { // pula linhas em branco
            $linhas[] = array_combine($cabecalho, $campos);
        }
    }
    fclose($f);
    return $linhas;
}

Cuidados

• Arquivos salvos no Excel como "CSV (separado por vírgulas)" costumam vir em Windows-1252, não em UTF-8. Se os acentos chegarem quebrados, leia com encoding="cp1252" no Python ou converta com mb_convert_encoding no PHP. A opção "CSV UTF-8" do Excel evita o problema.
• Valores que começam com =, +, - ou @ podem ser executados como fórmula quando o arquivo é aberto (a chamada injeção de CSV). Em dados vindos de usuários, prefixe esses valores com um apóstrofo.
• Para manter zeros à esquerda (CEP, CPF), importe a coluna como texto no Excel. No arquivo, o valor já está certo: é a abertura que o transforma em número.
• Se o arquivo não for para o Excel, e sim para outro sistema, use o padrão: vírgula, UTF-8 sem BOM e ponto decimal.