Todos os produtos
Search
Central de documentação

Function Compute:Como usar o WebIDE

Última atualização: Jun 29, 2026

O WebIDE é um ambiente de desenvolvimento integrado (IDE) online fornecido pelo Function Compute. Ele oferece uma experiência de desenvolvimento em nuvem semelhante à do VS Code nativo. Escreva, depure e implante código diretamente online, sem instalar um ambiente de desenvolvimento local complexo. Este tópico descreve os recursos do WebIDE, apresenta uma visão geral e explica como configurá-lo no console do Function Compute.

Limites

  • Atualmente, o WebIDE suporta apenas os runtimes Python, Node.js, PHP e personalizados. Não há suporte para edição online nos runtimes Java, Go ou C#. Para esses runtimes, faça upload apenas de arquivos ZIP compilados ou arquivos binários.

  • Cada usuário recebe 5 GB de espaço de armazenamento no WebIDE. As operações de gravação falharão após a ultrapassagem desse limite. Limpe seu espaço prontamente.

  • A abertura do WebIDE para uma função inicia automaticamente uma instância. Essa instância equivale a um contêiner com 1 vCPU e 1,5 GB de memória.

  • A instância do WebIDE usa o mesmo ambiente de runtime da sua função. No entanto, ela não carrega camadas personalizadas, recursos NAS ou OSS montados, nem acessa o ambiente VPC configurado para a função. Se precisar dessas capacidades, implante o código primeiro e invoque a função, ou use o Dedicated WebIDE.

  • O Dedicated WebIDE está disponível apenas nas seguintes regiões: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Hong Kong), Singapura, Japão (Tóquio), Alemanha (Frankfurt) e EUA (Virgínia). Para usar o Dedicated WebIDE em outras regiões, participe do grupo de usuários do DingTalk (ID do grupo DingTalk: 64970014484) e solicite acesso.

Visão geral da interface do WebIDE

No modo de tela cheia, a interface do WebIDE consiste em quatro áreas: Resource Manager, File Editor, Function Operations e Command Line Terminal.

  • Resource Manager: Visualize a estrutura do código, incluindo arquivos source e dependências.

  • File Editor: Edite o código da função. Após a edição, clique em image.png no canto superior direito para depurar o código. Para garantir consistência entre o terminal local e o ambiente de produção, clique em Deploy na área Function Operations.

  • Function Operations: Implante e teste o código da função. Ao sair do modo de tela cheia, essa área aparece no canto superior esquerdo da interface do WebIDE.

  • Command Line Terminal: Abra o terminal selecionando na barra de ferramentas na parte superior do WebIDE. Utilize o terminal para depurar código ou instalar dependências de terceiros.

Configurar o WebIDE no console

Pré-requisitos

Você criou uma função. Para mais informações, consulte Criar uma função.

Procedimento

  1. Faça logon no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Functions.

  2. Na barra de navegação superior, selecione uma região. Na página Functions, clique em a função de destino.

  3. Opcional: Na aba Code da página de detalhes da função, clique em Configure WebIDE no canto superior direito. No painel Configure WebIDE, selecione um tipo de WebIDE.

    Escolha entre Serverless WebIDE ou Dedicated WebIDE.

    • Serverless Edition

      Esta é a versão padrão. É gratuita, mas não permite acesso a recursos dentro de uma VPC nem montagem de NAS ou OSS.

    • Dedicated Edition

      Selecione Dedicated WebIDE se a instância precisar carregar camadas personalizadas, montar NAS ou OSS, ou acessar o ambiente VPC configurado para o serviço. Defina os seguintes itens de configuração:

      • Instance type plan

      • Execution Timeout Period

      Ao selecionar o Dedicated WebIDE, o Function Compute reutiliza ou cria automaticamente uma VPC, um vSwitch e um sistema de arquivos NAS de uso geral com base na configuração de VPC na região da função. Para obter detalhes sobre preços dos recursos criados automaticamente, consulte Faturamento do NAS de uso geral.

  4. Na interface do WebIDE, escreva, teste e instale dependências de terceiros para o código da função conforme necessário.

    Para obter detalhes sobre as áreas da interface do WebIDE, consulte Visão geral da interface do WebIDE.

Importante

Se você selecionar o Dedicated WebIDE, garanta que a função seja executada corretamente. Caso contrário, o WebIDE poderá falhar ao iniciar.

Perguntas frequentes

O que fazer se o WebIDE falhar ao carregar?

Atualize a página de detalhes da função ou redefina rapidamente o ambiente do WebIDE. Para obter instruções sobre como redefinir o ambiente do WebIDE, consulte Como redefinir rapidamente as variáveis de ambiente, o runtime e as camadas do WebIDE para uma função?.

O que é o Dedicated WebIDE?

O Dedicated WebIDE é essencialmente uma função FC implantada em sua conta Alibaba Cloud com um nome que começa com _webide-server-.

Com o Dedicated WebIDE, as instâncias podem carregar camadas personalizadas e recursos NAS ou OSS montados, além de acessar a VPC configurada para o serviço. Isso garante total consistência entre o terminal local e o ambiente de runtime de produção, aprimorando o desenvolvimento e a depuração. Também é possível selecionar um plano de tipo de instância — por exemplo, aumentar CPU e memória — para melhorar o desempenho do WebIDE.

Como o Dedicated WebIDE é executado em sua conta, custos adicionais são gerados:

Por que minha função tem sucesso no terminal, mas falha ao clicar em Test Function?

O WebIDE ajuda a testar código rapidamente, criar projetos e instalar dependências. No entanto, o ambiente do WebIDE não é o ambiente de execução real usado pelo Function Compute. Não é possível testar diretamente camadas personalizadas, NAS ou OSS montados, ou acesso a recursos baseados em VPC no WebIDE.

Para evitar esse problema, use o Dedicated WebIDE ou, após editar o código, clique em Deploy e, em seguida, em Test Function para executar testes.

Como redefinir rapidamente as variáveis de ambiente, o runtime e as camadas do WebIDE para uma função?

Ao atualizar a página de detalhes da função ou a interface do WebIDE, as variáveis de ambiente online mais recentes, as camadas e o runtime são atualizados automaticamente na instância do WebIDE. Execute env no terminal para visualizar as variáveis de ambiente da função mais recentes.

Por quanto tempo o Serverless WebIDE retém meu workspace?

Por padrão, os workspaces são retidos por 48 horas. Se a função não for aberta no WebIDE por 48 horas consecutivas, o conteúdo do workspace será excluído.

Além disso, se o código online for modificado via console ou ferramentas SDK, o code checksum da função muda. Atualizar ou reabrir o WebIDE sincroniza automaticamente o workspace com o código online mais recente.

Posso depurar código no WebIDE?

Sim. Use os plugins de depuração integrados do VS Code para cada runtime suportado. Para runtimes personalizados ou linguagens menos comuns, instale um plugin apropriado do VS Code.

Por exemplo, com Python 3.9, adicione código auxiliar para executar a função handler. O código de exemplo a seguir (index.py) mostra como depurar uma função Python no WebIDE. O bloco if __name__ == "__main__" serve como ponto de entrada de depuração local. Defina pontos de interrupção dentro da função handler para depurar:

import logging
import json
def handler(event, context):
    # evt = json.loads(event)
    logger = logging.getLogger()
    logger.info('hello world')
    logger.info('hello world2')
    return 'hello world'
if __name__=="__main__":
    event = b"hello"
    # if you use context in your code,
    # Please refer to 'https://www.alibabacloud.com/help/document_detail/422182.html' to construct context
    context = None
    handler(event, context)

Quando modifico uma função, o plugin Git mostra diferenças de código. Isso significa que o WebIDE hospeda o código da minha função?

Não. Na primeira vez que uma função é aberta no WebIDE, ele executa automaticamente git init para exibir diferenças entre o código atual e a versão online. Após clicar em Deploy Function uma vez, o WebIDE cria automaticamente um commit, garantindo que o terminal e o código online sejam idênticos (a mensagem save function with codechecksum xxxx indica uma implantação bem-sucedida). Esse recurso melhora a usabilidade.

Importante

Recomendamos que o pacote de código da função não inclua histórico Git. Exclua o diretório .git ao empacotar o código para evitar interferências com o WebIDE.

Dois usuários RAM sob a mesma conta Alibaba Cloud abrem a mesma função, mas veem códigos diferentes. Por quê?

O WebIDE do Function Compute isola workspaces para usuários RAM sob a mesma conta Alibaba Cloud. Por exemplo, o Usuário RAM A usa o WebIDE A e o Usuário RAM B usa o WebIDE B. As alterações feitas pelo Usuário RAM A em seu workspace não ficam visíveis para o Usuário RAM B; portanto, eles veem códigos diferentes.

Ambos os usuários RAM podem ver diferenças entre o código do workspace e o código da função online. Para mais informações, consulte Quando modifico uma função, o plugin Git mostra diferenças de código. Isso significa que o WebIDE hospeda o código da minha função?.

O que fazer se o terminal do WebIDE abrir lentamente ou falhar ao abrir?

Siga estas etapas para solucionar o problema:

  1. Verifique as configurações de rede. Garanta que o cliente local não bloqueie o acesso via proxy ou desative o protocolo WebSocket. O WebIDE usa WebSocket para comunicação em tempo real. Desativar o WebSocket impede o funcionamento correto do WebIDE.

  2. Verifique se a função está sendo aberta em uma região fora da China. Se a rede local tiver pouca conectividade transfronteiriça, a conexão com funções em regiões fora da China pode ser lenta ou falhar.

  3. Verifique se o pacote de código é muito grande. Pacotes grandes levam mais tempo para fazer upload ou implantar. Otimize o pacote de código e tente novamente.

Se o problema persistir após seguir estas etapas, entre em contato conosco.

Referências

  • Use também o terminal do WebIDE para empacotar dependências de terceiros para a função. Para mais informações, consulte Empacotar dependências de terceiros para uma função usando o WebIDE.

  • Se o código da função ou os pacotes de dependências de terceiros forem grandes, extraia dependências para uma camada ou use uma camada pública oficial do Function Compute para reduzir o tamanho do código. Para mais informações, consulte Criar uma camada personalizada.

  • Teste funções localmente usando o recurso de depuração local no Serverless Devs. Para mais informações, consulte Depuração local.