Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é heredoc?

    Um heredoc envia várias linhas à entrada de um comando no shell. No Bash, as aspas no delimitador controlam a expansão de variáveis e comandos no bloco.

    Também chamado de: here document, here-document

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Um heredoc é um redirecionamento que fornece um bloco de texto como entrada de um comando do shell. Você escreve o conteúdo na própria linha de comando ou no script, entre uma abertura com << e um delimitador de fechamento.

    O shell lê as linhas até encontrar o delimitador sozinho em uma linha e entrega o bloco ao comando. Por padrão, o conteúdo vai para a entrada padrão, que é o canal pelo qual o comando lê a entrada. O delimitador encerra a leitura e fica fora do texto entregue.

    Texto literal no Bash

    O comando abaixo envia duas linhas ao cat, que lê a entrada e a imprime no terminal. As aspas em 'FIM' fazem o Bash preservar o texto do bloco:

    Terminal
    cat <<'FIM'
    Primeira linha do exemplo.
    O texto $NOME permanece literal.
    FIM

    A saída contém as duas linhas intermediárias, incluindo $NOME exatamente como foi escrito. O fechamento usa apenas FIM, sem as aspas da abertura. Esse comando imprime o conteúdo, mas não grava um arquivo no projeto.

    Quando as variáveis são substituídas

    Com <<FIM, sem aspas no delimitador, o Bash expande as referências a variáveis e realiza expansões aritméticas no corpo. Assim, $NOME pode virar o valor da variável. A substituição de comandos também está ativa, por isso um trecho com $(comando) pode executar esse comando durante a preparação da entrada.

    Para fornecer uma configuração que precisa conter $NOME como texto literal, use o delimitador entre aspas, como no exemplo. Esse cuidado controla o tratamento feito pelo Bash. A interpretação posterior ainda depende do programa que recebe a entrada.

    Dúvidas frequentes

    Perguntas frequentes sobre heredoc

    Por que o Bash continua esperando depois da última linha?
    Com `<<`, a linha de fechamento precisa conter apenas o delimitador, sem espaços no início ou no fim. As aspas usadas na abertura não fazem parte desse fechamento.
    O que muda ao usar `<<-`?
    O Bash remove as tabulações iniciais das linhas do bloco e do delimitador de fechamento. Espaços comuns não recebem esse tratamento, por isso a indentação precisa ser conferida.
    Um heredoc pode executar o texto recebido?
    O comando que recebe o bloco determina como interpretá-lo. O `cat` imprime o texto, mas um interpretador pode executá-lo. Além disso, um delimitador sem aspas permite substituições de comandos pelo próprio Bash.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    Os comandos de terminal podem receber texto multilinha, com tratamento explícito das expansões feitas pelo shell.

    Conhecer a formação
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano