Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é lockfile?

    Um lockfile registra as versões escolhidas pelo gerenciador de dependências. Ele orienta novas instalações, mas a reprodução também depende do ambiente.

    Também chamado de: arquivo de versões resolvidas, arquivo de travamento de dependências

    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 que fica registrado no lockfile

    Um lockfile é um arquivo mantido pelo gerenciador de dependências para registrar as versões selecionadas na instalação de um projeto. No npm, o package-lock.json descreve a árvore instalada, incluindo as bibliotecas exigidas por outras dependências.

    O package.json pode aceitar um intervalo de versões. O lockfile registra qual versão foi escolhida dentro desse intervalo e permite reproduzir essa resolução em instalações posteriores. O arquivo deve acompanhar o código no controle de versão para que a mesma revisão do projeto tenha sua resolução identificada.

    Um intervalo aceita várias versões

    Num exemplo didático, o package.json declara uma biblioteca com o intervalo ^1.2.0. O lockfile registra a versão 1.2.3. Se esse arquivo for removido, uma nova resolução poderá selecionar 1.3.0, caso ela esteja disponível e atenda às demais condições da instalação.

    O código da aplicação continua igual, mas a biblioteca executada mudou. Você pode comparar as versões do lockfile para investigar uma falha que apareceu depois da reinstalação.

    Reproduzir a instalação com o npm

    O comando npm ci instala o projeto a partir de um lockfile existente e exige correspondência com o package.json. Ele encerra com erro quando os arquivos divergem e remove um diretório node_modules existente durante a preparação da instalação. Confira esse efeito ao escolher o procedimento.

    A versão do Node.js e a plataforma ainda influenciam a execução, especialmente com dependências nativas. Reproduzir a árvore de dependências permite comparar instalações, mas a compatibilidade da aplicação precisa ser conferida pelos testes no ambiente de destino.

    Dúvidas frequentes

    Perguntas frequentes sobre lockfile

    O lockfile substitui o package.json?
    Não. O package.json declara as dependências diretas do projeto e os intervalos aceitos. O package-lock.json registra a árvore resolvida pelo npm, incluindo dependências indiretas.
    O que acontece quando apago o lockfile?
    A próxima instalação pode resolver novamente as dependências e selecionar outras versões aceitas pelo manifesto. A remoção pode mudar o conjunto instalado mesmo sem alteração no código da aplicação.
    O npm ci atualiza um lockfile desatualizado?
    Não. Ele encerra com erro se as dependências do lockfile não corresponderem às do package.json. O comando também remove um node_modules existente para instalar o conjunto definido pelos arquivos do projeto.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    A instalação do projeto precisa preservar a identificação das dependências usadas para executar e validar o código.

    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