Módulo 8 - Arquivos CSV e pathlib

O que é CSV

9 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 01/07/2026

O que você vai aprender

  • Entender que CSV é uma tabela guardada como texto puro.
  • Reconhecer o separador de campo e a diferença entre vírgula e ponto e vírgula.
  • Saber onde CSV aparece: exportações, planilhas, bancos e sistemas.
  • Perceber por que CSV é um formato universal e durável.

CSV em uma frase

Imagine uma tabela de aula: uma coluna com o nome do aluno, outra com a nota e outra com a cidade. Agora imagine guardar essa tabela sem nenhuma planilha bonita, só como texto que você poderia digitar no bloco de notas. Cada aluno vira uma linha, e dentro da linha os três valores ficam separados por vírgula. Isso é um CSV. O nome vem do inglês comma-separated values, valores separados por vírgula. É simples de propósito, e é justamente essa simplicidade que o tornou universal.

nome,nota,cidade
Ana,9.5,Recife
Bruno,7.0,Salvador
Carla,8.5,Natal

Um CSV por dentro: a primeira linha é o cabeçalho, as demais são os registros.

Repare que não há mágica ali. É texto que um humano lê e um programa também. A primeira linha, nome,nota,cidade, é o cabeçalho: ela diz o significado de cada coluna. As linhas seguintes são os dados, uma por aluno. Se você abrir esse mesmo arquivo no Excel, no Google Sheets ou no LibreOffice, cada programa vai reconhecer as vírgulas e montar a tabela com três colunas. Abra no bloco de notas e você vê o texto cru. O CSV é os dois ao mesmo tempo.

Vírgula ou ponto e vírgula

Existe uma pegadinha clássica no Brasil. Como usamos a vírgula para separar as casas decimais dos números, escrever 9,5 no meio de um CSV separado por vírgula geraria confusão: o programa não saberia se a vírgula separa campos ou decimais. Por isso, muitos arquivos brasileiros, e o próprio Excel em português, usam o ponto e vírgula como separador de campo. Assim, 9,5 continua sendo um número e o ponto e vírgula separa as colunas. O nome CSV fica, mas o separador muda.

CSV com vírgula

  • Padrão internacional e do módulo csv
  • Números com ponto decimal: 9.5
  • nome,nota -> nome e nota
  • Comum em exportações de sistemas

CSV com ponto e vírgula

  • Comum no Brasil e no Excel em português
  • Números com vírgula decimal: 9,5
  • nome;nota -> nome e nota
  • Evita conflito com a vírgula decimal

Guarde essa informação: quando você for ler um CSV nas próximas aulas, o primeiro passo mental é olhar o separador. Se o arquivo veio de um sistema internacional, provavelmente é vírgula. Se veio de uma planilha brasileira, provavelmente é ponto e vírgula. O módulo csv, que você vai usar já na próxima aula, deixa isso explícito com o parâmetro delimiter, então não é um problema, apenas um detalhe que você precisa conferir uma vez.

Onde o CSV aparece no dia a dia

CSV é o idioma comum entre programas que não conversam de outro jeito. O banco exporta seu extrato em CSV. A loja online exporta a lista de pedidos em CSV. O sistema da empresa gera relatórios em CSV para você abrir na planilha. Ferramentas de análise de dados leem CSV. Até bases públicas do governo, como dados abertos de gastos e de licitações, costumam ser distribuídas em CSV, porque qualquer pessoa consegue abrir sem software especial. É um formato antigo, dos anos 1970, e continua vivo justamente porque é simples.

OndeExemplo típicoO que você faz com Python
BancoExtrato de conta exportadoSomar entradas e saídas do mês
E-commerceLista de pedidos e produtosContar vendas por categoria
PlanilhaExportação do Excel ou SheetsLer, filtrar e recalcular
Dados abertosGastos públicos em CSVCruzar e resumir informações
Sistemas internosRelatório diário automáticoProcessar sem abrir a planilha

O CSV é o formato de troca mais comum entre sistemas e planilhas.

A grande vantagem de saber ler CSV com Python é a automação. Abrir uma planilha de mil linhas e somar à mão é cansativo e sujeito a erro. Um programa de dez linhas faz a mesma soma em um piscar de olhos, do mesmo jeito toda vez, e você pode repetir com um arquivo novo no mês seguinte. É por isso que este módulo dedica tanto espaço ao CSV: ele é a porta de entrada dos dados reais para os seus programas. Nas próximas aulas você aprende a ler, a gravar e a montar um relatório completo.

Teste rápido

O que melhor descreve um arquivo CSV?

Perguntas frequentes

CSV é a mesma coisa que uma planilha do Excel?
Não exatamente. O CSV guarda só os dados em texto puro, sem cores, fórmulas, abas ou formatação. Um arquivo .xlsx do Excel guarda tudo isso. O Excel consegue abrir e salvar CSV, mas ao salvar como CSV ele descarta o que não é dado bruto.
Por que alguns CSV usam ponto e vírgula em vez de vírgula?
Porque no Brasil a vírgula já é usada para separar as casas decimais dos números, como em 9,5. Para não confundir a vírgula decimal com a vírgula que separa colunas, muitos arquivos e o Excel em português adotam o ponto e vírgula como separador de campo.
Todo CSV tem cabeçalho?
Não é obrigatório, mas é muito comum. O cabeçalho é a primeira linha com os nomes das colunas. Alguns arquivos vêm sem ele, só com os dados. Ao ler um CSV, vale conferir se a primeira linha é nome de coluna ou já é um registro.
Posso abrir um CSV sem instalar nada?
Sim. Como é texto puro, qualquer editor abre, inclusive o bloco de notas do Windows. Abrir no editor de texto é a melhor forma de conferir o separador e o cabeçalho antes de processar o arquivo com Python.
CSV serve para muitos dados ou só para tabelas pequenas?
Serve para volumes bem grandes também, com milhões de linhas. Como é lido linha a linha, o Python consegue processar arquivos enormes sem carregar tudo de uma vez na memória. Para consultas complexas, porém, um banco de dados costuma ser melhor que um CSV gigante.
Qual a diferença entre CSV e JSON?
CSV é ideal para dados tabulares, em formato de tabela com linhas e colunas iguais. JSON, visto no módulo anterior, é melhor para dados com estrutura aninhada, como um pedido que tem uma lista de itens dentro. Cada formato brilha em um cenário.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.