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
Documentação
npm: package-lock.json
Descreve a árvore de dependências registrada no package-lock.json e sua função nas instalações seguintes.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão de orientação técnica ao vivo para investigar falhas de instalação e conferir as dependências do seu projeto.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.