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.
Ouvir o resumo desta aula
Um recap de cerca de 2 minutos na voz do Valim, para ouvir no trânsito ou na academia.
Ler a transcrição do resumo
Resumo da aula: O que é CSV.
Os objetivos desta aula. 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.
Veja o essencial, parte por parte.
CSV em uma frase. CSV é uma tabela guardada como texto puro, que qualquer programa consegue abrir.
Vírgula ou ponto e vírgula. Abra o arquivo no bloco de notas e veja se as colunas usam vírgula ou ponto e vírgula.
Onde o CSV aparece no dia a dia. CSV é o idioma comum entre programas que não conversam de outro jeito.
Esse foi o resumo do essencial. Para se aprofundar, leia a aula completa e responda os exercícios.
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,NatalUm 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.
| Onde | Exemplo típico | O que você faz com Python |
|---|---|---|
| Banco | Extrato de conta exportado | Somar entradas e saídas do mês |
| E-commerce | Lista de pedidos e produtos | Contar vendas por categoria |
| Planilha | Exportação do Excel ou Sheets | Ler, filtrar e recalcular |
| Dados abertos | Gastos públicos em CSV | Cruzar e resumir informações |
| Sistemas internos | Relatório diário automático | Processar 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.