Todos os produtos
Search
Central de documentação

Function Compute:Como usar o WebIDE

Última atualização: Oct 28, 2026

O WebIDE é um ambiente de desenvolvimento integrado (IDE) online fornecido pelo Function Compute. Ele oferece uma experiência de desenvolvimento em cloud semelhante ao 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 binários.

  • Cada usuário recebe 5 GB de espaço de armazenamento no WebIDE. As operações de gravação falharão se esse limite for excedido. Limpe seu espaço regularmente.

  • 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), Singapore, Japan (Tokyo), Germany (Frankfurt) e US (Virginia). Para usar o Dedicated WebIDE em outras regiões, entre no 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 editar, 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. Use 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 Create a function.

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 na 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 suporta acesso a recursos dentro de uma VPC ou montagem de NAS ou OSS.

    • Dedicated Edition

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

      • Instance type plan

      • Execution Timeout Period

      Se você 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 sua função. Para detalhes de preços sobre recursos criados automaticamente, consulte General-purpose NAS billing.

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

    Para detalhes sobre as áreas da interface do WebIDE, consulte WebIDE interface overview.

Importante

Se você selecionar o Dedicated WebIDE, certifique-se de que sua função execute corretamente. Caso contrário, o WebIDE pode falhar ao iniciar.

Perguntas frequentes

O que devo fazer se o WebIDE falhar ao carregar?

Atualize a página de detalhes da função ou reinicie rapidamente o ambiente do WebIDE. Para instruções sobre como redefinir o ambiente do WebIDE, consulte How do I quickly reset the WebIDE environment variables, runtime, and layers for a function?.

O que é o Dedicated WebIDE?

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

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

Importante

Todos os workspaces do Dedicated WebIDE sob a mesma conta Alibaba Cloud compartilham um único sistema de arquivos NAS. Os workspaces são separados por diretórios, em vez de usarem sistemas de arquivos NAS independentes.

Como o Dedicated WebIDE é executado sob sua conta, você incorre em custos adicionais:

  • Taxas de invocação de função e uso de recursos do Function Compute. Para mais informações, consulte Billing overview.

  • Taxas para montagem de um sistema de arquivos NAS. Para mais informações, consulte General-purpose NAS billing.

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

O WebIDE ajuda você 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. Você não pode 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 seu código, clique em Deploy e, em seguida, clique em Test Function para executar testes.

Como redefino 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 você não abrir a função 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 atualiza automaticamente o workspace para corresponder ao 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 você abre uma função no WebIDE, ele executa automaticamente git init para exibir diferenças entre seu código atual e a versão online. Depois que você clica em Deploy Function uma vez, o WebIDE cria automaticamente um commit, garantindo que seu 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 sua função não inclua histórico Git. Exclua o diretório .git ao empacotar seu 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 são 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 When I modify a function, the Git plugin shows code differences. Does this mean WebIDE hosts my function code?.

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

Siga estas etapas para solucionar o problema:

  1. Verifique suas configurações de rede. Certifique-se de que seu 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 que o WebIDE funcione corretamente.

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

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

Se o problema persistir após seguir estas etapas, contact us.

Referências

  • Use também o terminal do WebIDE para empacotar dependências de terceiros para sua função. Para mais informações, consulte Package third-party dependencies for a function using WebIDE.

  • Se o código da sua função ou 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 Create a custom layer.

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