Todos os produtos
Search
Central de documentação

Qoder CN Series:Guia de Solução de Problemas

Última atualização: Sep 25, 2026

Este tópico descreve como usar o script de diagnóstico do Qoder CN para solucionar problemas como falhas de inicialização do Qoder CN. O script coleta automaticamente o contexto do ambiente do sistema, configurações de rede, status do service Qoder CN e logs relacionados, ajudando você a identificar e resolver problemas com rapidez.

Qoder CN

Importante

O novo site de documentação do Qoder CN já está disponível. O conteúdo deste site pode não refletir os recursos e alterações mais recentes do product. Acesse docs.qoder.cn para obter a documentação mais atualizada do product.

1. Baixe e Execute o Script

Baixe e execute a ferramenta de diagnóstico correspondente ao seu sistema operacional:

Windows Environment

  1. Baixe o script: Baixe o arquivo windows_lingma.bat.

  2. Execute o script: localize o arquivo, clique com o botão direito e selecione Run as administrator.

  3. Visualize os resultados: ao concluir, o script abre automaticamente o arquivo de log gerado. O caminho do log é exibido na janela de linha de comando e, normalmente, o arquivo fica no mesmo diretório do script, com o nome Qoder CN_Log_Date_Time.txt.

Linux/macOS Environment

  1. Baixe o script: Baixe o arquivo linuxormac_lingma_cn.sh.

  2. Execute o script: Abra o Terminal, acesse o diretório do script e execute os seguintes comandos:

    1. Conceda permissão de execução ao script.

      chmod +x Linuxormac_lingma_cn.sh
    2. Execute o script.

      ./Linuxormac_lingma_cn.sh
  3. Visualize os resultados: ao concluir, o script gera um arquivo de log, normalmente no mesmo diretório do script, com o nome Qoder CN_Log_Date_Time.txt.

2. Sugestões de Solução de Problemas com Base nos Resultados do Diagnóstico

As orientações a seguir se aplicam a todos os sistemas operacionais (Windows, macOS, Linux). Use o arquivo de log gerado para solucionar os problemas conforme descrito abaixo:

Tipo de Problema

Item do Problema

Solução

Rede

Verificar configurações de proxy

O script verifica se um proxy está ativo. Consulte as seções "[Network Settings]" ou "[Proxy Settings]" para confirme que as configurações estão conforme o esperado. Se você utiliza um proxy, configure manualmente configure the network proxy para o Qoder CN nas configurações.

Status do Service Qoder CN

Existência do processo Qoder CN

O script primeiro verifica se o processo do Qoder CN existe (Lingma.exe no Windows; lingma no macOS e Linux). Em caso de erro, verifique se o caminho de instalação está correto. Exclua o diretório .lingma, reinicie o IDE e regenere o diretório .lingma.

Versão e teste de inicialização

Revise as seções "[version test]" e "[Start Qoder CN]". Confirme as informações de versão do Qoder CN e verifique se ele consegue se conectar ao servidor de rede pública. Se "failed" for exibido, configure um proxy nas configurações para acessar a rede pública, utilizando a URL indicada na mensagem de erro.

O processo inicia, mas o login permanece sem resposta

Windows: Adicione o arquivo do processo à lista de permissões do Windows Firewall (Painel de Controle\Sistema e Segurança\Windows Defender Firewall\Allowed apps). Em seguida, tente fazer login novamente: C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe.macOS/Linux: Verifique as configurações do firewall do sistema. Certifique-se de que o processo do Qoder CN tem permissão de acesso à rede.

Quando um programa incompatível é reportado

Ao usar o IDEA, a descompactação pode falhar por memória heap insuficiente. Clique em o ícone do Qoder CN no canto inferior direito, selecione Advanced Settings e altere o caminho para um diretório fora do disco do sistema (encerrando com uma pasta vazia). Em seguida, reinicie o IDEA.

Nota

Algumas empresas bloqueiam programas binários internamente, impedindo sua execução.

O que fazer quando "Qoder CN is starting" é exibido (ou quando um erro de inicialização é reportado e o service não responde)?

  1. Confirme o suporte ao sistema operacional e à arquitetura do sistema. Se compatível, verifique no Gerenciador de Tarefas (Windows), no Monitor de Atividade (macOS) ou no Monitor do Sistema (Linux) se o processo lingma está em execução.

  2. Caso contrário, atualize o Qoder CN para a versão mais recente e siga os passos abaixo:

    1. Encerre o processo do Qoder CN.

    2. Exclua o diretório .lingma (Windows: C:\Users\[username]\.lingma; macOS/Linux: ~/.lingma).

    3. Reinicie o IDE com permissões administrativas (Windows) ou permissões sudo (macOS/Linux).

  3. Se o problema persistir, execute o comando de inicialização no diretório .lingma/bin/x.x.x/.Windows: Na linha de comando (cmd), execute Lingma.exe start.macOS/Linux: No Terminal, execute ./lingma start. Após o processo aparecer, clique em login novamente.

  4. Se um programa incompatível for reportado, provavelmente ocorreu uma falha na descompactação (possivelmente por memória heap insuficiente do IDE). Clique em o ícone do Qoder CN no canto inferior direito, selecione Advanced Settings e altere o caminho para um diretório fora do disco do sistema (encerrando com uma pasta vazia). Reinicie o IDE em seguida.

Compatibilidade do Sistema

Informações do sistema e hardware

O script coleta versões do sistema operacional e modelos de CPU. Revise a seção "[Operating System Information]" e confirme se os requisitos de sistema do Qoder CN são atendidos.

Análise de Log

Logs da aplicação Qoder CN

O arquivo de log gerado registra as últimas linhas (normalmente 80 linhas) do "lingma.log". Isso facilita a identificação de erros ou avisos específicos durante a execução do Qoder CN. Analise as mensagens de erro no log para investigar o problema.

Estrutura de diretórios e tamanho dos arquivos

O script também exibe a estrutura do diretório de instalação do Qoder CN e o tamanho de cada arquivo. Utilize essas informações para verificar o uso de espaço ou validar a integridade dos arquivos.

Problemas que você não consegue resolver de forma independente

Participe do grupo DingTalk "Qoder CN Public Preview Discussion Group (for answers to common questions, see the group announcement first)", número do grupo: 53770000738, e entre em contato com o assistente de suporte oficial.