Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Vibe Coding: Do Zero ao MVP

    O que é caminho normalizado?

    Um caminho normalizado tem segmentos e separadores ajustados pela função utilizada. No Node.js, esse tratamento textual não verifica a existência do arquivo.

    Também chamado de: path normalization

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    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

    O ajuste acontece no texto do caminho

    Um caminho normalizado é uma string de caminho com os segmentos e os separadores ajustados pelas convenções de uma função ou sistema. No Node.js, path.normalize trata segmentos como ., que indica o diretório atual, e .., que indica o diretório anterior. Também reúne separadores consecutivos conforme a plataforma.

    Essa função recebe uma string e devolve outra, sem abrir o arquivo indicado. O resultado depende das convenções utilizadas: o Node.js oferece path.posix para caminhos POSIX e path.win32 para caminhos Windows. Escolher uma dessas versões permite explicitar o formato tratado pelo código.

    De uma sequência relativa a outra

    Neste exemplo didático em Node.js, a versão POSIX trata um caminho relativo com uma referência ao diretório anterior e uma barra repetida:

    import path from 'node:path'
    console.log(path.posix.normalize('relatorios/../imagens//logo.png'))
    // Resultado: imagens/logo.png

    O segmento .. cancela textualmente relatorios. As duas barras entre imagens e logo.png viram uma só. O resultado continua relativo e não informa se a imagem existe ou se a aplicação tem permissão para abri-la.

    O destino exige outra conferência

    Links simbólicos podem fazer o sistema de arquivos percorrer um destino diferente daquele sugerido pelo ajuste textual. A própria documentação do Node.js ressalva que remover segmentos .. pode mudar como o sistema resolve um caminho. Portanto, a normalização não comprova que duas strings levam ao mesmo arquivo.

    Você precisa conferir o destino permitido pela aplicação e tratar o acesso efetivo ao arquivo. Um caminho como ../privado.txt pode continuar contendo uma referência ao diretório anterior depois da normalização. Reescrever a string não concede permissão nem restringe a consulta a uma pasta autorizada.

    Dúvidas frequentes

    Perguntas frequentes sobre caminho normalizado

    Normalizar um caminho confirma que o arquivo existe?
    No Node.js, path.normalize trabalha com a string recebida. A existência do arquivo só pode ser conferida por uma consulta ao sistema de arquivos.
    Um caminho normalizado sempre é absoluto?
    A normalização pode produzir um caminho relativo. No exemplo do verbete, imagens/logo.png continua relativo, pois a função não acrescenta o diretório atual.
    A normalização resolve links simbólicos e autoriza o acesso?
    path.normalize não consulta o destino dos links simbólicos nem as permissões do arquivo. A aplicação precisa verificar o destino permitido e tratar a abertura do arquivo.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao revisar código gerado por agentes, você precisa distinguir o ajuste textual de um caminho da verificação do arquivo que a aplicação pode acessar.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    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