Solução de problemas da CLI
Resolva problemas de seleção de arquivos, linha de base, coleta e catálogo sem precisar excluir dados de estado úteis primeiro.
Ao diagnosticar uma falha, tenha à mão a versão instalada, o comando, o diretório de trabalho, o erro e os caminhos afetados. Oculte as credenciais antes de compartilhar logs: os diagnósticos de inicialização e de falha podem incluir o conteúdo bruto de argv.
Nenhum arquivo de origem correspondeu a #
Localize o .lingo/config.json mais próximo. Um comando executado em um subdiretório pode usar o projeto de um diretório superior. Verifique include antes de pattern, pois até uma inclusão vazia tem precedência sobre ele. As exclusões se aplicam a cada entrada individualmente; outra entrada ainda pode selecionar o arquivo.
Use uma sintaxe de correspondência compatível, como docs/en/**/*, coloque os padrões de shell entre aspas e confira o suporte a sufixos. YAML exige yaml, yaml-root-key ou yaml-openapi de forma explícita; XML do Android exige android. Um arquivo .txt, .csv ou .properties precisa de um padrão que termine com a extensão do arquivo, ou de "format": "txt", "format": "csv" ou "format": "properties"; um padrão genérico como docs/en/**/* ignora esse arquivo, e uma entrada txt, csv ou properties ignora todos os arquivos que não tenham essa extensão. Especificar um formato não significa que todas as extensões serão aceitas.
A saída foi para o lugar errado #
Leia os avisos de derivação de caminhos e compare o destino com o carregador da sua aplicação. Quando nenhum segmento de idioma de origem for reconhecido, defina targetPath e sourceRoot em vez de depender da inserção de idioma como alternativa. Mantenha os destinos fora da busca de arquivos de origem e verifique se há colisões.
Mover os arquivos não basta para atualizar a linha de base. Por definição, o XCStrings usa um único catálogo de origem compartilhado, e não a estrutura comum de arquivos separados por idioma. Consulte caminhos de saída.
Uma opção não tem efeito #
Chaves desconhecidas na raiz ou nas entradas de arquivo geram avisos e são ignoradas. Verifique a grafia e quais opções o manipulador selecionado realmente aceita. As configurações de caminho do catálogo não atualizam os padrões do comando push, e os comandos extract e check adotam en como idioma de origem padrão, cada um de forma independente.
A pontuação local usa o executável lingo.config.ts, não o JSON do projeto. Uma opção de proteção de JSON não controla necessariamente o Markdown ou outro formato.
Um artefato da linha de base está ausente #
O artefato de origem anterior identificado pelo hash no Lockfile precisa existir localmente ou no servidor. Inspecione a entrada indicada e recupere os bytes de uma versão comprovadamente válida ou uma linha de base coerente. Não invente um hash nem apague todo o Lockfile para ocultar o erro.
Sem os dados de estado, um primeiro push simples armazena os bytes de origem; para destinos comuns ausentes, é necessário fazer o preenchimento retroativo. Lockfile e cache explica de qual registro a operação precisa.
O comando pull informa um conflito #
Execute lingo pull --dry-run para inspecionar as decisões de gravação. Um destino que difere da saída do servidor, dos bytes capturados no momento do push e do hash no Lockfile bloqueia as gravações. Registrar esse destino em um commit não altera a comparação.
Preserve e concilie a edição, restaure uma versão conhecida ou opte por forçar apenas se a substituição for intencional. Não edite os destinos durante push --wait, que não faz a nova verificação de conflitos realizada pelo comando pull.
O trabalho falhou ou continua incompleto #
Inspecione os erros de cada destino e diferencie trabalho pendente, revisão, falha e saídas ausentes. Uma execução com falha faz com que push --wait e o comando pull terminem com código diferente de zero após gravar os documentos concluídos; verifique o estado e os arquivos efetivamente gerados.
Quando todos os destinos ainda não concluídos estão aguardando revisão humana, push --wait e o comando pull param de esperar e informam o motivo. Os documentos com todos os idiomas concluídos podem ser coletados; execute lingo pull novamente depois que os revisores terminarem. Fazer outro push não resolve a espera por revisão.
Se a execução falhou, corrija a causa informada e repita o comando adequado ao trabalho. Para atualizações comuns da origem, use lingo push --wait sem alterar a origem nem descartar a linha de base. Para arquivos de destino ausentes, repita o preenchimento retroativo somente depois que os destinos existentes estiverem atualizados, seguindo Adicionar um idioma. Não é preciso editar a origem, usar uma opção para forçar ou excluir o estado apenas para solicitar outra tentativa.
O comando push exibe o ID da tarefa que envia ou à qual se reconecta. Se o push anterior ainda não foi coletado e a solicitação não mudou, o comando push reutiliza essa solicitação: uma tarefa ainda em execução mantém seu ID, e uma tarefa com falha é substituída por uma nova. Guarde o ID da tarefa com falha e confirme que a próxima linha Job exibida tem um ID diferente. Isso indica um novo envio, não que a tradução foi bem-sucedida: inspecione os resultados de cada destino, obtenha a saída e revise as diferenças. Mantenha os destinos locais inalterados durante --wait; se precisar proteger edições locais, execute push e pull separadamente, usando a verificação de conflitos do pull.
Se o cliente instalado retornar a mesma tarefa com falha, pare de repetir os envios e envie um e-mail para support@lingo.dev. Inclua a versão da CLI, o comando sem dados sensíveis, os IDs da execução anterior e da execução retornada, a revisão da origem, os idiomas e caminhos afetados, as datas e os horários e o erro com os dados sensíveis ocultados. Não inclua credenciais, texto de origem privado nem arquivos brutos de credenciais na mensagem. Preserve o ponteiro local da execução e o Lockfile enquanto a falha é investigada.
Excluir o ponteiro da execução não é uma forma confiável de solicitar uma nova tradução; enquanto um push não é coletado, o ponteiro mantém a identidade da solicitação que evita envios duplicados. Se nenhuma execução for encontrada, verifique a máquina, o caminho absoluto da raiz do projeto e se outro push substituiu o ponteiro.
As verificações do catálogo falham #
Execute extract com o mesmo idioma e os mesmos caminhos usados em check. Inspecione os avisos de chamadas dinâmicas ou desestruturadas antes de remover entradas órfãs. A ausência de um arquivo de destino só é informada quando os padrões de files correspondem ao catálogo de origem; caso contrário, compare os idiomas esperados com os arquivos existentes.
Remova apenas o que foi excluído intencionalmente, gere as declarações novamente e execute o comando check e a compilação da aplicação. status foi movido para check; nomes de serviços internos não são comandos executáveis.
Antes de excluir qualquer coisa #
Limpar mostra uma prévia da exclusão dos arquivos de destino. Os filtros de arquivo e idioma limitam a exclusão aos destinos selecionados e às respectivas entradas no Lockfile; uma execução de purge sem filtros remove todo o Lockfile. Os catálogos XCStrings compartilhados são ignorados. Use o comando purge quando a intenção for realmente excluir. A maioria das tarefas de recuperação exige uma correção específica, preservando os textos aceitos e os dados de estado que podem ser recuperados.