library(reprex)
# copie o código abaixo e execute reprex() no console
library(dplyr)
dados <- tibble(municipio = c("A", "B"), casos = c("10", "20"))
dados |> summarise(total = sum(casos))Apêndice D — Erros frequentes e como pedir ajuda
Errar faz parte do trabalho com qualquer linguagem de programação, para iniciantes e para quem programa há anos. A diferença está em saber ler a mensagem de erro, encontrar a causa e, quando necessário, pedir ajuda de forma que outra pessoa consiga ajudar. Este apêndice reúne os erros mais comuns entre quem está começando, organizados pela etapa do trabalho em que costumam aparecer, e apresenta estratégias para buscar ajuda.
Erro, aviso e mensagem
O R se comunica de três formas. Um erro (Error) interrompe a execução: o comando não foi concluído e nenhum resultado foi produzido. Um aviso (Warning) indica que o comando foi executado, mas que algo pode não ter saído como esperado, e merece ser lido com atenção. Uma mensagem é apenas informativa, como as que aparecem ao carregar o tidyverse ou quando read_csv() informa os tipos das colunas. A primeira providência diante de um erro é ler a mensagem com calma, de preferência a última linha, que costuma dizer o que o R esperava e o que encontrou.
Erros frequentes
| Mensagem (ou sintoma) | Causa provável | Como corrigir |
|---|---|---|
could not find function "..." |
O pacote da função não foi carregado, ou o nome está escrito errado | Executar library(pacote) ou conferir a grafia, inclusive maiúsculas e minúsculas |
there is no package called '...' |
O pacote não está instalado | Instalar com install.packages("pacote"), com o nome entre aspas |
object '...' not found |
O objeto não foi criado, o nome está errado ou a linha que o cria não foi executada | Conferir a grafia e executar o código anterior; em documentos Quarto, lembrar que o documento roda em uma sessão nova |
cannot open file '...': No such file or directory |
O caminho do arquivo está errado ou o projeto não está aberto | Abrir o projeto do RStudio e usar here("dados", "arquivo.csv") |
| Acentos trocados por símbolos estranhos | Codificação do arquivo diferente da indicada | Usar locale = locale(encoding = "latin1") em read_csv2() |
| Números lidos como texto, ou com valores errados | Separador decimal ou de colunas incorreto | Usar read_csv2() para arquivos com ponto e vírgula e vírgula decimal |
| Códigos de município perdem zeros ou viram números | A coluna foi lida como número | Indicar col_types = cols(CODMUNRES = col_character()) |
unexpected symbol, unexpected ')' ou '}' |
Parênteses, aspas ou vírgulas faltando ou sobrando | Conferir o comando com o realce de parênteses do RStudio |
O console mostra + e não responde |
Um comando ficou incompleto, por exemplo, com parênteses ou aspas abertos | Pressionar Esc e corrigir o comando |
non-numeric argument to binary operator |
Operação matemática com texto | Verificar o tipo da coluna com class() ou glimpse() e convertê-la |
Resultado NA em mean() ou sum() |
Há valores ausentes no vetor | Usar na.rm = TRUE, depois de verificar quantos são e por quê |
`=` em vez de == em filter() |
Confusão entre atribuição e comparação | Usar == para comparar |
Error in ggplot... object not found dentro de aes() |
Nome de coluna escrito errado | Conferir os nomes com names() |
+ no começo da linha em um gráfico |
O + do ggplot2 deve ficar no fim da linha anterior |
Mover o + para o fim da linha |
Can't combine ... <character> and ... <double> |
Tentativa de empilhar ou juntar colunas de tipos diferentes | Converter as colunas para o mesmo tipo antes de bind_rows() ou do join |
| Junção com mais linhas do que o esperado | A chave tem valores repetidos em uma das tabelas | Verificar a unicidade da chave com count() seguido de filter(n > 1) |
| O documento Quarto não renderiza, mas o código funciona no console | O código depende de algo feito só no console, como um objeto criado à mão ou um pacote carregado fora do documento | Colocar no documento tudo o que ele usa, incluindo library(), e reiniciar o R antes de testar |
Como buscar ajuda
A documentação de cada função é a primeira fonte de consulta. Ela é aberta com ?nome_da_funcao ou help(nome_da_funcao) e traz a descrição dos argumentos, os detalhes do funcionamento e exemplos executáveis no final da página, que podem ser copiados para o console. Muitos pacotes também têm vinhetas, textos mais longos com exemplos de uso, listadas com vignette(package = "nome_do_pacote"). As folhas de referência (cheatsheets) da Posit, disponíveis no menu Help do RStudio, resumem em uma ou duas páginas as principais funções de pacotes como dplyr, ggplot2 e lubridate.
A busca na internet é muito eficiente quando se usa o texto da mensagem de erro, sem as partes específicas do seu código, como nomes de objetos, acompanhado do nome do pacote e da palavra “R”. Como a maior parte do conteúdo sobre R está em inglês, buscar a mensagem em inglês costuma trazer mais resultados. Para que as mensagens apareçam em inglês, pode-se executar Sys.setenv(LANGUAGE = "en") no início da sessão.
Os fóruns reúnem perguntas e respostas sobre praticamente todos os problemas comuns. O Stack Overflow (https://stackoverflow.com/, com a etiqueta r) e o fórum da comunidade Posit (https://forum.posit.co/) são os mais usados. Antes de perguntar, vale procurar se a dúvida já foi respondida.
Exemplo mínimo reprodutível
Quem vai ajudar precisa conseguir reproduzir o problema no próprio computador. Por isso, uma boa pergunta traz um exemplo mínimo reprodutível: o menor trecho de código que, executado em uma sessão nova do R, mostra o problema. Ele deve conter os pacotes usados, um pequeno conjunto de dados (criado no próprio código ou de um pacote, como os do medicaldata) e o código que produz o erro, sem nada além disso. Muitas vezes, o próprio esforço de reduzir o problema ao mínimo já revela a sua causa.
O pacote reprex facilita essa tarefa. Basta copiar o código para a área de transferência e executar reprex::reprex(). O pacote roda o código em uma sessão nova e devolve, já copiado, o código com os resultados e as mensagens, formatado para ser colado em um fórum.
O resultado mostra o erro invalid 'type' (character) of argument e permite a quem lê perceber, sem precisar dos seus dados, que a coluna casos foi criada como texto. Se os dados do problema forem sensíveis, como microdados de saúde, eles nunca devem ser compartilhados. Nesses casos, cria-se um pequeno conjunto fictício com a mesma estrutura, ou usa-se a função dput() em algumas linhas já desidentificadas e alteradas.
Assistentes de inteligência artificial
Ferramentas de inteligência artificial podem ajudar a interpretar mensagens de erro e a sugerir código. Elas podem, porém, produzir código com funções ou argumentos que não existem, ou que não fazem o que se pretende. Todo código sugerido deve ser lido, compreendido e testado antes de ser usado, e os resultados devem ser conferidos. Também aqui vale a regra de não compartilhar dados sensíveis.