Codificação UTF-8 explicada: como o texto se transforma em bytes e como corrigir texto ilegível

  1. Início
  2. Blog
  3. Desenvolvimento de software

Desenvolvimento de Software

Codificação UTF-8 explicada: Como o texto se transforma em bytes e como corrigir texto ilegível

A codificação UTF-8 armazena cada caractere Unicode como 1 a 4 bytes e é o padrão para a web, JSON e a maioria dos códigos. Aprenda como funciona byte por byte, por que o texto se transforma em algo sem sentido como um café e as 6 correções que impedem a codificação de bugs para sempre.

9 min de leitura
Codificação UTF-8 explicada

Principais pontos

  • Codificação UTF-8 transforma pontos de código Unicode em bytes: 1 byte para ASCII, 2 para é, 3 para letras € e Hindi, 4 para a maioria dos emojis.
  • Texto ilegível como café significa que os bytes UTF-8 foram decodificados com a codificação errada; os dados geralmente ainda estão corretos.
  • Até mesmo nossa própria demonstração travou com UnicodeEncodeError em um console do Windows que usava cp1252.
  • Sempre nomeie a codificação ao ler e gravar arquivos: open(path, encoding="utf-8").

Mais cedo ou mais tarde, todo desenvolvedor percebe isso: um cliente chamado “José” aparece como “José”, um sinal de rupia se torna “€” ou um script morre com UnicodeDecodeError. Esses bugs parecem aleatórios, mas seguem regras simples. Depois de entender a codificação UTF-8, você poderá prevê-las e corrigi-las em minutos. Cada valor de byte neste guia vem do código que executamos no Python 3.13.6 no Windows.

Unicode vs UTF-8: duas coisas diferentes

Unicode é uma lista gigante de caracteres numerados. Cada caractere possui um ponto de código, escrito como U+00E9 para é. UTF-8 é uma maneira de armazenar esses números como bytes em arquivos, mensagens de rede e memória. Existem outras codificações, como UTF-16 e o ​​antigo Windows-1252 (cp1252), mas UTF-8 domina a web, JSON, HTML, Linux e a maioria das ferramentas de programação.

Pense em Unicode como o alfabeto e em UTF-8 como a caligrafia. A mesma carta pode ser escrita em escritas diferentes, e a confusão começa quando o leitor assume a escrita errada.

Como UTF-8 codifica caracteres

for ch in ["A", "é", "€", "ह", "😀"]:
    b = ch.encode("utf-8")
    print(ch, f"U+{ord(ch):04X}", len(b), b.hex(" ").upper())
Personagem Ponto de código Bytes UTF-8 Feitiço Bytes UTF-16
Um U+0041 1 41 2
é U+00E9 2 C3 A9 2
€ U+20AC 3 E2 82 AC 2
ह (hindi) U+0939 3 E0 A4 B9 2
😀 U+1F600 4 F0 9F 98 80 4

O design é inteligente. O ASCII simples mantém seu byte único, portanto o texto antigo em inglês já é UTF-8 válido. Pontos de código maiores usam mais bytes, e os primeiros bits de cada byte indicam quantos bytes pertencem ao caractere, para que o leitor sempre saiba onde termina um caractere. Esse design de autossincronização é o motivo pelo qual o UTF-8 venceu.

Caracteres não são bytes

len("café")            # 4 characters
len("café".encode())   # 5 bytes

A contagem de bytes depende do script. Medimos três frases curtas:

Texto Personagens Bytes UTF-8 Bytes UTF-16
Inglês 28 28 56
Hindi 32 84 64
Japonês 17 51 34

UTF-8 é compacto para inglês e código, e maior para muitos scripts asiáticos. Isso é importante sempre que um limite é definido em bytes: colunas de banco de dados, SMS, cabeçalhos HTTP, cargas de API. Um limite de 100 bytes contém 100 letras em inglês, mas apenas cerca de 33 em hindi. A mesma lição “um personagem não é uma unidade” se aplica à IA, como mostra nosso guia de tokens LLM. Mesmo len("👍🏽") retornou 2 em Python, porque um emoji de tom de pele tem dois pontos de código.

Por que o texto fica distorcido (mojibake)

O texto distorcido tem um nome: mojibake, do japonês para “transformação de personagem”. Acontece quando bytes escritos como UTF-8 são lidos como outra coisa:

"café".encode("utf-8").decode("cp1252")    # 'café'

Os dois bytes para é, C3 A9, significam “Ô e “©” no Windows-1252, então um caractere se tornou dois. Se o texto errado for salvo e mal interpretado novamente, a situação fica pior: nossa dupla viagem de ida e volta produzida café. Escrevemos ₹500 café em um arquivo em UTF-8 e o lemos como cp1252; saiu como ₹500 café.

A boa notícia: os bytes originais geralmente estão intactos, então o dano pode ser revertido repetindo o erro ao contrário:

"café".encode("cp1252").decode("utf-8")   # 'café'

Dica: ao ver os padrões Ã, †ou Â, pense “UTF-8 lido como cp1252 ou Latin-1”. Quando você vê � (o caractere de substituição), os bytes eram inválidos e algumas informações podem ser perdidas.

UnicodeDecodeError explicado

O erro oposto é ler bytes cp1252 ou Latin-1 como UTF-8. Em Latin-1, é é um único byte E9, que não é uma sequência UTF-8 válida por si só:

b"caf\xe9".decode("utf-8")
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 3: unexpected end of data

Opções, da melhor para a pior: descobrir a codificação real e decodificar com ela (b"caf\xe9".decode("latin-1") retornou “café”), ou, se for preciso continuar, usar errors="replace", que deu caf� e perde o caractere. Nunca silencie erros nos dados que você precisa manter. A leitura correta de arquivos é abordada em nosso guia de manipulação de arquivos Python.

Nossa surpresa no console

Ao escrever este artigo, nosso primeiro script de demonstração travou antes de imprimir a linha em hindi:

UnicodeEncodeError: 'charmap' codec can't encode character 'ह' in position 1: character maps to <undefined>

O código estava correto. O problema foi a saída: Python relatou sys.stdout.encoding como cp1252 naquele shell do Windows e cp1252 não possui letras em hindi. Executar com a variável de ambiente PYTHONIOENCODING=utf-8 corrigiu o problema, e o modo UTF-8 do Python (python -X utf8) é outra opção. É um exemplo perfeito de como os bugs de codificação vivem nos limites: arquivos, consoles, bancos de dados e redes, não nas strings dentro do seu programa.

A lista técnica: bytes invisíveis no início

Algumas ferramentas do Windows adicionam uma marca de ordem de bytes, EF BB BF, no início dos arquivos UTF-8. Lido com simples utf-8, ele aparece como um caractere invisível:

"hi".encode("utf-8-sig")                     # b'\xef\xbb\xbfhi'
b"\xef\xbb\xbfhi".decode("utf-8")            # 'hi'
b"\xef\xbb\xbfhi".decode("utf-8-sig")        # 'hi'

Esse desvio  quebra cabeçalhos CSV (“nome” não é mais igual a “nome”) e analisadores JSON. Leia arquivos que possam ter uma BOM com encoding="utf-8-sig", que a remove, se presente. Nosso guia Python JSON aborda o carregamento de arquivos de dados com segurança.

Mesmo texto, bytes diferentes: normalização

a = "é"           # one code point U+00E9
b = "é"     # e + combining accent
print(a == b, len(a), len(b))                    # False 1 2
print(unicodedata.normalize("NFC", b) == a)      # True

Ambos parecem idênticos na tela, mas são pontos de código diferentes, portanto, comparações, pesquisas e restrições exclusivas os tratam como diferentes. O texto colado do macOS ou de alguns teclados geralmente usa a forma decomposta. Normalize a entrada do usuário para NFC antes de compará-la ou armazená-la.

6 correções que evitam erros de codificação

  1. Nomeie a codificação em todos os lugares: open(p, encoding="utf-8"). Nossa máquina Windows relatou cp1252 como padrão, portanto, confiar nos padrões quebra nas máquinas.
  2. Declarar UTF-8 na web: <meta charset="utf-8"> em HTML e Content-Type: text/html; charset=utf-8 em respostas. JSON é UTF-8 por especificação, e nosso guia de melhores práticas da API REST se baseia.
  3. Use Unicode completo em bancos de dados: no MySQL escolha utf8mb4, não o mais antigo utf8, que não pode armazenar caracteres de 4 bytes como emoji (não executamos o MySQL para este artigo).
  4. Decodifique nas bordas, trabalhe no texto interno: converta bytes em strings quando os dados chegarem e voltem quando eles saírem.
  5. Trate de BOMs e normalize a entrada: use utf-8-sig para arquivos desconhecidos e NFC para texto do usuário.
  6. Teste com dados reais em idiomas diferentes do inglês: inclua é, ₹, hindi, japonês e um emoji em seus dados de teste e verifique APIs, exportações de CSV e e-mails de ponta a ponta.

Sintoma a ser corrigido: pesquisa rápida

Você vê Causa provável Correção
café, ₹, à padrões Bytes UTF-8 lidos como cp1252 ou Latin-1 Leia como UTF-8; ou .encode("cp1252").decode("utf-8") para reparar
caf� com marcas de substituição Bytes inválidos substituídos na decodificação Encontre a codificação de origem; caracteres substituídos não podem ser recuperados
UnicodeDecodeError Bytes não UTF-8 lidos como UTF-8 Decodifique com a codificação real
UnicodeEncodeError ao imprimir Console ou arquivo usa uma codificação limitada PYTHONIOENCODING=utf-8 ou python -X utf8
O nome da primeira coluna CSV não corresponderá Lista técnica oculta () Leia com utf-8-sig
Strings de aparência idêntica não são iguais Normalização Unicode diferente unicodedata.normalize("NFC", s)
Emoji salvo como ???? no MySQL A coluna usa 3 bytes utf8 Mudar para utf8mb4

Confirmamos as primeiras seis linhas no Python 3.13; a linha MySQL é um conselho padrão que não testamos aqui. Quando um bug de codificação ultrapassa os limites da API, verifique também o cabeçalho Content-Type, que deve nomear charset=utf-8 para respostas de texto.

Considerações finais

A codificação UTF-8 é basicamente simples: Unicode numera os caracteres, UTF-8 armazena os números como 1 a 4 bytes e cada string distorcida é uma incompatibilidade entre como os bytes foram escritos e como foram lidos. Nomeie a codificação em cada limite, prefira UTF-8 de ponta a ponta e teste com texto multilíngue real. Você raramente verá um café novamente e, quando o fizer, saberá exatamente como reverter isso.

Perguntas frequentes

O que é codificação UTF-8?

UTF-8 é uma codificação de comprimento variável que armazena cada caractere Unicode como 1 a 4 bytes. Os caracteres ASCII usam 1 byte, portanto o texto simples em inglês é idêntico em ASCII e UTF-8.

Qual é a diferença entre Unicode e UTF-8?

Unicode atribui um número, chamado ponto de código, a cada caractere. UTF-8 é uma forma de armazenar esses números como bytes. UTF-16 e UTF-32 são outras formas.

Por que meu texto mostra caracteres estranhos como É?

Os bytes UTF-8 foram decodificados como Windows-1252 ou Latin-1. Leia os dados como UTF-8 ou reverta o dano codificando o texto ilegível de volta com a codificação errada e decodificando-o como UTF-8.

Como faço para corrigir UnicodeDecodeError em Python?

Abra o arquivo com a codificação em que ele foi realmente escrito, como encoding=latin-1 ou utf-8-sig, em vez de confiar no padrão. Use erros=substituir somente quando a perda de caracteres for aceitável.

Quantos bytes um caractere UTF-8 usa?

Um a quatro. ASCII usa 1 byte, a maioria das letras com acento europeu usa 2, hindi, chinês e muitos símbolos usam 3, e a maioria dos emoji usa 4.

Continue aprendendo

Trabalhe com Stack Quora

Precisa de ajuda com testes, WordPress ou SEO?

Ajudamos as equipes a fornecer software melhor e a expandir seus sites. Conte-nos no que você está trabalhando e sugeriremos um próximo passo claro.

Continue lendo

Mais guias sobre testes, IA e desenvolvimento moderno

Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.

Inteligência artificial

BM25 explicado: como a pesquisa por palavra-chave classifica os resultados, com código Python e pesquisa híbrida

BM25 explicou com uma implementação Python pura que executamos: a fórmula, IDF, saturação de termo, os parâmetros k1 e b, por que supera a contagem …

Leia o artigo →
Desenvolvimento de software

Métodos HTTP explicados: GET, POST, PUT, PATCH, DELETE, testados em um servidor Live

Métodos HTTP explicados com um pequeno servidor que executamos: GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS, seguro vs idempotente, PUT vs PATCH, …

Leia o artigo →
DevOps

Git Bisect explicado: encontre o commit que quebrou seu código, manual ou automaticamente

Git bisect explicado com um repositório testado: encontre o commit incorreto entre 41 em 5 execuções de teste, automatize-o com git bisect run, pule…

Leia o artigo →
Automação de testes

Marcadores pytest explicados: marcas personalizadas, filtros skip, skipif, xfail e -m

marcadores pytest explicados com um conjunto testado: registre marcas personalizadas, execute apenas testes de fumaça com -m, combine filtros com e,…

Leia o artigo →
Teste de software

Testes Positivos vs Negativos: Diferenças, 24 Casos de Teste Reais e uma Lista de Verificação

Testes positivos versus negativos explicados com um formulário de inscrição real: 6 casos de teste positivos e 18 negativos executados em pytest, a …

Leia o artigo →
Bancos de dados e SQL

SQL ORDER BY Várias Colunas: ASC, DESC, NULLS LAST, Case e Ordem Personalizada

SQL ORDER BY com múltiplas colunas explicadas com consultas testadas: ASC e DESC mistos, desempates, NULLS FIRST e LAST, classificação sem distinção…

Leia o artigo →
Bancos de dados e SQL

Total em execução do SQL: SUM OVER, totais por grupo, somas móveis e armadilha RANGE

Como calcular um total de execução SQL com SUM() OVER: totais por grupo, somas cumulativas diárias, somas móveis, porcentagem do total, armadilha de…

Leia o artigo →
Desenvolvimento de software

Matriz de classificação JavaScript: números, objetos, strings e por que 10 vem antes de 5

Como classificar um array em JavaScript corretamente: números com função de comparação, objetos por um ou mais campos, strings com localeCompare, da…

Leia o artigo →
Desenvolvimento de software

Métodos de string Python: folha de dicas, exemplos reais e a armadilha strip()

Métodos de string Python com exemplos testados: split, join, strip, replace, find, startupswith, is-methods, casefold, partition e translate, além d…

Leia o artigo →
Inteligência artificial

Explicação da similaridade de cossenos: fórmula, exemplo resolvido e código Python

A similaridade de cosseno é explicada de forma simples: a fórmula, um exemplo trabalhado à mão, código Python e NumPy puro, cosseno versus distância…

Leia o artigo →
Desenvolvimento de software

Codificação UTF-8 explicada: como o texto se transforma em bytes e como corrigir texto ilegível

Codificação UTF-8 explicada com exemplos em nível de byte que executamos em Python: como os caracteres se tornam de 1 a 4 bytes, por que café se tra…

Leia o artigo →
Automação de testes

parametrização pytest explicada: 7 padrões com exemplos testados

parametrização pytest explicada com 7 padrões testados: casos básicos, ids legíveis, decoradores empilhados, pytest.param com xfail e skip, fixtures…

Leia o artigo →
Teste de software

Reteste versus teste de regressão: 8 diferenças principais com um exemplo real de correção de bug

Reteste versus teste de regressão explicado com uma correção de bug real executada em pytest: o reteste confirmou a correção, a execução de regressã…

Leia o artigo →
Bancos de dados e SQL

Excluir linhas duplicadas em SQL: 5 métodos seguros, testados passo a passo

Como excluir linhas duplicadas no SQL com segurança: encontre-as, visualize-as e remova-as com ROW_NUMBER, MIN(id), EXISTS, rowid ou uma nova tabela…

Leia o artigo →
Bancos de dados e SQL

SQL RANK vs DENSE_RANK vs ROW_NUMBER: diferenças com exemplos testados

SQL RANK vs DENSE_RANK vs ROW_NUMBER em uma tabela: como cada um lida com empates, N principais por grupo, a segunda armadilha salarial mais alta e …

Leia o artigo →
Desenvolvimento de software

Encadeamento opcional de JavaScript (?.) Explicado: 8 exemplos, ?? Padrões e armadilhas

O encadeamento opcional de JavaScript interrompe erros “Não é possível ler propriedades de indefinidos”. 8 exemplos testados para propriedades, arra…

Leia o artigo →
Desenvolvimento de software

Python enumerate() explicado: 7 exemplos, start=1 e erros a evitar

Python enumerate() fornece o índice e o valor em um loop limpo. 7 exemplos testados, o truque start=1, dicionários, arquivos, números rápidos e 3 er…

Leia o artigo →
Inteligência artificial

Estratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos

Estratégias de chunking RAG comparadas em um documento com tiktoken 0.14: tamanho fixo, sobreposição, empacotamento de frases, divisão recursiva e p…

Leia o artigo →
Desenvolvimento de software

Explicação da idempotência da API: chaves de idempotência e novas tentativas seguras, testadas

A idempotência da API explicada com um servidor e cliente Python que executamos: uma resposta perdida causava uma cobrança dupla sem uma chave e uma…

Leia o artigo →
DevOps

Git Stash explicado: salvar, aplicar, abrir e não rastrear arquivos, testado

Git stash explicado com comandos que executamos no Git 2.56: push com uma mensagem, arquivos não rastreados, listar e mostrar, aplicar vs pop, mante…

Leia o artigo →
Teste de software

Explicação do teste em pares: como todos os pares reduzem 216 testes para 13, testados

Testes em pares explicados com um gerador que executamos em Python 3.13: um checkout com 216 combinações cobertas por 13 testes, cobertura verificad…

Leia o artigo →
Automação de testes

Duplas de teste explicadas: Dummy, Stub, Spy, Mock e Fake, com código Python testado

O teste duplo é explicado com um exemplo de Python executado no pytest 9.2: dummy, stub, spy, mock e fake, quando usar cada um, verificações de esta…

Leia o artigo →
Bancos de dados e SQL

SQL COALESCE explicado: padrões, NULLIF, IFNULL vs ISNULL e traps, testados

SQL COALESCE explicado com consultas que executamos no SQLite 3.50: primeiros valores não nulos, strings vazias, NULL em matemática, NULLIF para div…

Leia o artigo →
Bancos de dados e SQL

SQL Self Join explicado: funcionário-gerente, comparações de pares e linhas, testado

Auto-junção SQL explicada com consultas que executamos no SQLite 3.50: funcionário e gerente, ganhando mais que o gerente, pares únicos, alterações …

Leia o artigo →
Desenvolvimento de software

Explicação do operador JavaScript Spread: Spread vs Rest, cópias e pegadinhas, testado

O operador de propagação JavaScript explicado com o código que executamos no Nó 24: arrays, objetos, cópias superficiais, parâmetros restantes, o li…

Leia o artigo →
Desenvolvimento de software

Functools Python explicado: lru_cache, parcial, redução, wraps e muito mais, testado

Functools do Python explicados com código que executamos no Python 3.13: lru_cache e cache, parcial, redução, wraps, cached_property, singledispatch…

Leia o artigo →
Desenvolvimento de software

Módulo de coleções Python explicado: contador, defaultdict, deque e mais, testado

Coleções Python explicadas com código que executamos em Python 3.13: Counter, defaultdict, deque, nomeadotuple, OrderedDict e ChainMap, além de um t…

Leia o artigo →
Inteligência artificial

Janela de contexto LLM explicada: tokens, limites e como ajustar mais, medidos

A janela de contexto do LLM explicada com contagens de tokens que medimos usando tiktoken: palavras versus tokens para prosa, código e hindi, orçame…

Leia o artigo →
Desenvolvimento de software

Webhooks explicados: como funcionam e como recebê-los com segurança

Webhooks explicados com um receptor e remetente que executamos em Python: push vs polling, assinaturas HMAC-SHA256, rejeição de solicitações adulter…

Leia o artigo →
DevOps

Git Cherry-Pick explicado: copie o commit que você precisa, com segurança e testado

Git cherry-pick explicado com comandos que executamos no Git 2.56: copiar um hotfix para um branch de lançamento, novos hashes e patch-ids, -x, -n, …

Leia o artigo →
Automação de testes

Explicação do teste instantâneo: como funciona, quando ajuda e quando dói

O teste de instantâneo foi explicado com uma demonstração pytest e xaroposa que executamos: criação de instantâneos, leitura da diferença após uma a…

Leia o artigo →
Teste de software

Explicação do teste de mutação: por que a cobertura de 100% ainda não percebeu nosso bug

Os testes de mutação explicados com uma pequena ferramenta de mutação que construímos e executamos: 14 mutantes, um conjunto de testes com 100% de c…

Leia o artigo →
Bancos de dados e SQL

Funções SQL JSON explicadas: consulta, atualização e indexação JSON em SQL, testadas

Funções SQL JSON explicadas com consultas que executamos no SQLite 3.50: json_extract, os operadores -> e ->>, json_each, json_set, json_pa…

Leia o artigo →
Bancos de dados e SQL

SQL Pivot explicado: transforme linhas em colunas com CASE, FILTER e PIVOT

SQL pivot explicado com consultas que executamos no SQLite 3.50: agregação condicional com CASE e SUM, FILTER, NULL vs zero, totais, colunas dinâmic…

Leia o artigo →
Inteligência artificial

Explicação da injeção imediata: como os aplicativos de IA são enganados e como defendê-los

Injeção imediata explicada para construtores: ataques diretos e indiretos, por que os filtros de palavras-chave falham (nosso teste bloqueou 1 de 4)…

Leia o artigo →
DevOps

Registros DNS explicados: A, AAAA, CNAME, MX, TXT e TTL com pesquisas reais

Registros DNS explicados com pesquisas que executamos: como funciona a resolução, A e AAAA, regras CNAME, MX e MX nulo, TXT para SPF e verificação, …

Leia o artigo →
DevOps

Sinalizadores de recursos explicados: lançamentos seguros, lançamentos graduais e higiene de sinalizadores

Sinalizadores de recursos explicados com uma simulação de implementação que executamos: tipos de sinalizadores, implementações percentuais com hashi…

Leia o artigo →
Automação de testes

Geração de dados de teste com Python Faker: dados realistas, repetíveis e seguros

Teste a geração de dados com Python Faker, execute e meça: propagação de dados repetíveis, localidades, valores exclusivos, registros em formato de …

Leia o artigo →
Teste de software

Explicação do teste Shift-Left: Encontre bugs mais cedo, sem atrasar a equipe

O teste shift-left explicou: o que significa, por que os defeitos iniciais são mais baratos, práticas desde revisões de requisitos até verificações …

Leia o artigo →
Bancos de dados e SQL

Funções de string SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT e limpeza de dados

Funções de string SQL explicadas com consultas que executamos: concatenação e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, preenchimento, com…

Leia o artigo →
Bancos de dados e SQL

Explicação dos gatilhos SQL: gatilhos ANTES e DEPOIS, registros de auditoria e armadilhas

Gatilhos SQL explicados com gatilhos que executamos: ANTES vs DEPOIS, ANTIGO e NOVO, logs de auditoria, validação, atualizações de estoque, condiçõe…

Leia o artigo →
Desenvolvimento de software

Módulo JSON Python explicado: dumps, carregamentos, tipos personalizados e erros comuns

O módulo Python JSON explicado com o código que executamos: dumps e carregamentos, arquivos, conversões de tipo, datas e decimais, codificadores per…

Leia o artigo →
Desenvolvimento de software

Módulos ES vs CommonJS: como funcionam as importações de JavaScript em Node.js, testado

Módulos ES vs CommonJS explicados com código que executamos em Node.js: sintaxe de importação e exportação, require, vinculações ativas, cache, espe…

Leia o artigo →
Desenvolvimento de software

Python Regex explicado: padrões, grupos, antecipações e armadilhas, testados

Regex Python explicado com padrões que executamos: pesquisa vs correspondência, findall, grupos e grupos nomeados, ganancioso vs preguiçoso, sub, lo…

Leia o artigo →
Inteligência artificial

Explicação da saída estruturada do LLM: obtendo JSON confiável de modelos de IA

Saída estruturada do LLM explicada com validação que executamos no Pydantic: modo JSON e esquemas, decodificação restrita, formas de quebra de saída…

Leia o artigo →
DevOps

Chaves SSH explicadas: como funcionam, ssh-keygen, Ed25519 e hábitos seguros

Chaves SSH explicadas com chaves que geramos: chaves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, impressões digitais, senhas, agente s…

Leia o artigo →
DevOps

Cache HTTP explicado: controle de cache, ETag e respostas 304, com um teste ao vivo

Cache HTTP explicado com um pequeno servidor que executamos: diretivas Cache-Control, idade máxima, sem cache vs sem armazenamento, revalidação de E…

Leia o artigo →
Automação de testes

Teste de contrato de API explicado: detecte alterações importantes antes de serem enviadas

O teste de contrato de API foi explicado com uma verificação de esquema que executamos: o que é um contrato, contratos orientados ao consumidor, Pac…

Leia o artigo →
Teste de software

Testes baseados em riscos explicados: avalie os riscos, construa uma matriz e teste o que é importante

Testes baseados em riscos explicados passo a passo: identificação de riscos, pontuação de probabilidade e impacto, construção de uma matriz de risco…

Leia o artigo →
Bancos de dados e SQL

Restrições SQL explicadas: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testadas

Restrições SQL explicadas com testes que executamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, as lacunas NULL, configuração de chave…

Leia o artigo →
Bancos de dados e SQL

Funções de data SQL explicadas: adicionando, comparando e agrupando datas sem bugs

Funções de data SQL explicadas com consultas que executamos: adição de intervalos, surpresas de final de mês, diferenças de data, armadilha BETWEEN,…

Leia o artigo →
Desenvolvimento de software

Python assíncio explicado: assíncrono, espera, coleta e TaskGroup com Real Timings

Python asyncio explicado com código que cronometramos: corrotinas, espera, coleta, TaskGroup, tratamento de erros, tempos limite, limitação de simul…

Leia o artigo →
Desenvolvimento de software

Debounce vs Throttle em JavaScript: como funcionam, quando usar cada um, testado

Debounce vs. acelerador em JavaScript explicado com tempos que medimos em Node.js: como cada um funciona, implementações simples, chamadas iniciais …

Leia o artigo →
Desenvolvimento de software

Gerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais

Os gerenciadores de contexto Python explicados com o código que executamos: como funciona, __enter__ e __exit__, contextlib.contextmanager, supressã…

Leia o artigo →
Inteligência artificial

Temperatura LLM e Top-p explicados: como os modelos de IA escolhem sua próxima palavra

Temperatura LLM e top-p explicados com uma simulação que executamos: como as probabilidades são remodeladas, o que top-p mantém, configurações recom…

Leia o artigo →
DevOps

YAML explicado: sintaxe, o problema da Noruega e outras armadilhas que testamos

YAML explicado com um teste de analisador: sintaxe básica, listas e mapas, o problema da Noruega, versões que se transformam em carros flutuantes, c…

Leia o artigo →
DevOps

Cron Jobs explicado: sintaxe, programações reais e os erros que os quebram

Cron jobs explicados com cronogramas que verificamos: os cinco campos, operadores, exemplos reais, a armadilha do dia do mês OU do dia da semana, pr…

Leia o artigo →
Inteligência artificial

Explicação das alucinações de IA: por que os modelos de linguagem inventam as coisas e como reduzi-las

Explicação das alucinações de IA: o que são, por que os modelos de linguagem as produzem, tipos comuns, como reduzi-las com aterramento e instruções…

Leia o artigo →
DevOps

Variáveis de ambiente explicadas: arquivos .env, segredos e configuração bem feitos

Variáveis de ambiente explicadas com exemplos de Python que executamos: leitura e configuração, por que cada valor é uma string, arquivos .env, hera…

Leia o artigo →
Desenvolvimento de software

Explicação da limitação de taxa de API: algoritmos, cabeçalhos e tratamento de erros 429

Limitação de taxa de API explicada com uma simulação que executamos: token bucket, janela fixa, janela deslizante, 429 respostas, cabeçalhos de limi…

Leia o artigo →
Automação de testes

Zombando em Python: unittest.mock, patch e os erros que fazem os testes mentirem

Zombaria em Python com unittest.mock, testado: Mock e return_value, side_effect, patch onde um nome é usado, especificação e autospec, zombaria de d…

Leia o artigo →
Teste de software

Cobertura de código explicada: cobertura de linha versus filial e o que 100% realmente significa

Cobertura de código explicada com uma execução cobertura.py real: cobertura de linha, ramal e condição, leitura de um relatório, por que 100% de cob…

Leia o artigo →
Bancos de dados e SQL

DELETE vs TRUNCATE vs DROP em SQL: diferenças, reversão e quando usar cada um

DELETE vs TRUNCATE vs DROP explicado com SQL testado: o que cada um remove, rollback, aciona, redefinição de identidade, velocidade e como PostgreSQ…

Leia o artigo →
Bancos de dados e SQL

Exibições SQL explicadas: crie, use e evite as armadilhas, com exemplos

Visualizações SQL explicadas com consultas que executamos: criação de uma visualização, resultados ao vivo, ocultação de colunas, desempenho, visual…

Leia o artigo →
Desenvolvimento de software

Interface TypeScript vs tipo: diferenças reais, testadas com o compilador

Interface TypeScript versus tipo, verificada com o compilador real: o que ambos podem fazer, o que apenas um pode fazer, mesclagem de declarações, e…

Leia o artigo →
Desenvolvimento de software

Python *args e **kwargs explicados: funções flexíveis com exemplos claros

Python *args e **kwargs explicados com o código que executamos: empacotamento e descompactação, ordem dos parâmetros, argumentos somente de palavras…

Leia o artigo →
Desenvolvimento de software

Funções Python Lambda: sintaxe, usos reais e quando não usá-los

Funções lambda do Python explicadas com o código que executamos: sintaxe, classificação com chave, mapa e filtro, fechamentos, armadilha de ligação …

Leia o artigo →
Inteligência artificial

O que são agentes de IA? Como eles funcionam, com um loop de agente simples que você pode executar

O que são agentes de IA? Um guia simples para o loop do agente, ferramentas, memória e proteções, com um pequeno loop Python que executamos, riscos …

Leia o artigo →
DevOps

Monitoramento versus observabilidade: a verdadeira diferença, com logs, métricas e rastreamentos

Explicação do monitoramento versus observabilidade: falhas conhecidas e desconhecidas, logs, métricas e rastreamentos, um passo a passo do incidente…

Leia o artigo →
DevOps

Docker Volumes vs Bind Mounts: persista os dados do contêiner da maneira certa

Volumes Docker versus montagens de ligação explicadas: por que os dados do contêiner desaparecem, volumes nomeados, montagens de ligação, tmpfs, exe…

Leia o artigo →
Automação de testes

TDD vs BDD: principais diferenças, um recurso criado de ambas as maneiras e quando usar cada um

TDD vs BDD explicado com um recurso de desconto construído em ambos os sentidos: refatoração vermelho-verde com o código que executamos, cenários da…

Leia o artigo →
Teste de software

Teste de aceitação do usuário (UAT): processo, lista de verificação e exemplos reais

Explicação do teste de aceitação do usuário: quem o executa, como ele difere do controle de qualidade, um processo de sete etapas, um modelo de caso…

Leia o artigo →
Bancos de dados e SQL

Valores SQL NULL explicados: IS NULL, COALESCE, NULLIF e as armadilhas a serem evitadas

Valores SQL NULL explicados com consultas que executamos: lógica de três valores, IS NULL, COALESCE, NULLIF, como agregações, junções e classificaçã…

Leia o artigo →
Bancos de dados e SQL

Instrução SQL CASE WHEN: sintaxe, exemplos reais e erros comuns

SQL CASE WHEN explicado com consultas que executamos: formulários simples e pesquisados, ordem de condição, pivôs com SUM, truques COUNT, classifica…

Leia o artigo →
Desenvolvimento de software

O que é JWT? JSON Web Tokens explicados com um exemplo prático

O que é JWT? JSON Web Tokens explicados: as três partes, um token construído e adulterado no código que executamos, JWT vs sessões, armazenamento, t…

Leia o artigo →
Desenvolvimento de software

Loop de eventos JavaScript explicado: pilha de chamadas, microtarefas e temporizadores com exemplos

O loop de eventos JavaScript explicado com o código que executamos: pilha de chamadas, filas de tarefas e microtarefas, por que setTimeout 0 não é i…

Leia o artigo →
Desenvolvimento de software

Geradores Python e rendimento explicado: economize memória com exemplos reais

Geradores Python e rendimento explicados com o código que executamos: como eles pausam e reiniciam, medem economia de memória, pipelines, sequências…

Leia o artigo →
Inteligência artificial

O que são incorporações? Similaridade de vetores e cossenos explicada de forma simples

O que são incorporações? Um guia em linguagem simples para vetores, similaridade de cossenos e pesquisa semântica, com um pequeno exemplo que execut…

Leia o artigo →
DevOps

Implantação azul-verde vs canário: diferenças, compensações e como escolher

Explicação da implantação azul-verde versus canário: como cada um funciona, custo, risco e reversão, agrupamento estável de usuários que testamos, m…

Leia o artigo →
Automação de testes

Testes instáveis: o que os causa e como corrigi-los para sempre

Testes instáveis explicados com demonstrações que executamos: as principais causas, como confirmar e diagnosticar uma, soluções adequadas para tempo…

Leia o artigo →
Teste de software

Teste de carga versus teste de estresse: diferenças, métricas e exemplos k6

Teste de carga versus teste de estresse explicado: o que cada um prova, testes de pico e absorção, as métricas que importam, por que as médias engan…

Leia o artigo →
Teste de software

Caso de teste versus cenário de teste: principais diferenças, exemplos e quando usar cada um

Caso de teste vs cenário de teste explicado: definições claras, uma tabela lado a lado, um recurso de redefinição de senha retirado de cenários para…

Leia o artigo →
Bancos de dados e SQL

Otimização de consultas SQL: leia planos de execução e corrija consultas lentas, com intervalos

Otimização de consulta SQL testada em um milhão de linhas: leia planos de execução, adicione os índices corretos, corrija filtros não sargáveis, use…

Leia o artigo →
Bancos de dados e SQL

SQL UNION vs UNION ALL: diferenças, exemplos e desempenho testado

SQL UNION vs UNION ALL explicado com consultas que executamos: duplicatas, as regras que ambos seguem, um bug de dados real, desempenho medido, INTE…

Leia o artigo →
Desenvolvimento de software

Tutorial da API JavaScript Fetch: GET, POST, tratamento de erros e tempos limite

Um tutorial da API JavaScript Fetch testado em um servidor local: GET e POST, por que 404 não lança, um auxiliar reutilizável, strings de consulta, …

Leia o artigo →
Desenvolvimento de software

Manipulação de arquivos Python: leitura, gravação, CSV, JSON e pathlib com exemplos

Manipulação de arquivos Python explicada com código que executamos: modos abertos, com, leitura de arquivos grandes, CSV, JSON, pathlib, arquivos bi…

Leia o artigo →
Desenvolvimento de software

Classes e objetos Python: tutorial OOP com exemplos reais

Classes e objetos Python explicados com código que executamos: __init__, métodos, atributos de classe vs instância, herança, propriedades, métodos d…

Leia o artigo →
Inteligência artificial

O que é um modelo de linguagem grande? Como funcionam os LLMs, explicado sem exageros

O que é um modelo de linguagem grande? LLMs explicados em linguagem simples: tokens, incorporações, atenção, treinamento, temperatura e janelas de c…

Leia o artigo →
DevOps

Comandos Linux para iniciantes: o guia essencial do terminal com exemplos

Comandos Linux para iniciantes, agrupados por tarefa: navegação, arquivos, visualização de logs, grep, pipes, permissões, processos e arquivos, com …

Leia o artigo →
Automação de testes

Selenium vs Playwright: principais diferenças, código comparado e qual escolher

Selenium vs Playwright comparado: arquitetura, espera, suporte a navegador e linguagem, depuração, o mesmo teste em ambas as ferramentas, conselhos …

Leia o artigo →
Teste de software

Particionamento de equivalência: técnica de design de teste explicada com exemplos resolvidos

Explicação do particionamento de equivalência: como encontrar partições válidas e inválidas, exemplos resolvidos para idades, senhas e cupons, teste…

Leia o artigo →
Teste de software

Gravidade vs Prioridade em Testes de Software: Diferenças, Matriz e Exemplos Reais

Explicação da gravidade versus prioridade em testes de software: definições claras, uma matriz de quatro vias com exemplos, escalas de nível, quem d…

Leia o artigo →
Bancos de dados e SQL

Tutorial de subconsultas SQL: tipos, subconsultas correlacionadas e EXISTS com exemplos

Um tutorial de subconsultas SQL com consultas que executamos: subconsultas escalares, IN, FROM e SELECT, subconsultas correlacionadas, EXISTS, a arm…

Leia o artigo →
Bancos de dados e SQL

Transações SQL e ACID explicados: COMMIT, ROLLBACK e níveis de isolamento

Transações SQL e ACID explicadas com uma transferência bancária que executamos: COMMIT, ROLLBACK, savepoints, locks, níveis de isolamento, leituras …

Leia o artigo →
Desenvolvimento de software

Folha de dicas dos comandos do Git: os comandos que você realmente usa, com exemplos

Uma folha de dicas de comandos Git agrupada por tarefa: configuração, preparação, ramificações, controles remotos, stash, histórico e desfazer erros…

Leia o artigo →
Desenvolvimento de software

Explicação das promessas de JavaScript: então, catch, Promise.all e erros comuns

Promessas JavaScript explicadas com o código que executamos: estados, cadeias then e catch, tratamento de erros, Promise.all, allSettled, race e any…

Leia o artigo →
Desenvolvimento de software

Tutorial do dicionário Python: métodos, exemplos e padrões comuns

Um tutorial de dicionário Python com código que executamos: criar, ler e atualizar dictos, métodos-chave, mesclagem, compreensão, padrões de contage…

Leia o artigo →
Inteligência artificial

O que é RAG? Geração aumentada de recuperação explicada com um exemplo prático

O que é RAG? Geração aumentada de recuperação explicada passo a passo: indexação, chunking, embeddings, recuperação, um pequeno exemplo funcional de…

Leia o artigo →
DevOps

Tutorial Terraform para iniciantes: infraestrutura como código do primeiro arquivo aos módulos

Um tutorial do Terraform para iniciantes: comece sem conta na nuvem, aprenda como iniciar, planejar e aplicar, depois variáveis, saídas, estado, mód…

Leia o artigo →
DevOps

Docker vs Kubernetes: principais diferenças, como eles funcionam juntos e o que você precisa

Docker vs Kubernetes explicado: o que cada um faz, o mesmo aplicativo rodando com ambos, Docker Compose e Swarm comparados, a mudança do dockershim …

Leia o artigo →
Automação de testes

Tutorial Pytest para iniciantes: luminárias, parametrização e exemplos reais

Um tutorial pytest para iniciantes com testes que executamos no pytest 9.2: asserções, fixtures, parametrizar, conftest, marcadores, tmp_path, monke…

Leia o artigo →
Teste de software

Ciclo de vida de teste de software (STLC): 6 fases, critérios de entrada e saída, exemplo

O ciclo de vida de teste de software explicou: seis fases do STLC com critérios de entrada e saída, resultados, um exemplo de recurso de login funci…

Leia o artigo →
Desenvolvimento de software

Git merge vs rebase: diferenças, exemplos e quando usar cada um

Git merge vs rebase explicado com saída real do log, uma tabela comparativa, a regra de ouro do rebase e um fluxo de trabalho seguro para equipes.

Leia o artigo →
Desenvolvimento de software

List comprehension em Python: sintaxe, exemplos e quando evitar

List comprehension em Python explicada: sintaxe, filtros, if-else, laços aninhados, tempos medidos e quando um laço for comum é a melhor escolha.

Leia o artigo →
Bancos de dados e SQL

SQL JOIN explicado com exemplos (Inner, Left, Right, Full)

Entenda os joins SQL passo a passo com tabelas e consultas de exemplo: INNER, LEFT, RIGHT, FULL, CROSS e SELF, além de erros comuns e dicas de desem…

Leia o artigo →