O campo devDependencies
Uma dev dependency é uma dependência usada para desenvolver, testar ou gerar uma aplicação. O npm registra esses pacotes no campo devDependencies do package.json. Um compilador pode ficar nessa categoria porque é necessário para produzir os arquivos executáveis a partir do código-fonte.
A separação permite escolher quais dependências instalar em cada ambiente. Na raiz do projeto, a instalação pode incluir as ferramentas de desenvolvimento. A opção --omit=dev permite omitir esse grupo do diretório node_modules, embora as dependências continuem registradas no arquivo de versões package-lock.json.
O compilador precisa estar no ambiente de geração
Num projeto que usa o compilador TypeScript para gerar JavaScript, o pacote typescript pode ser uma dependência de desenvolvimento. Com um package-lock.json compatível com o package.json, você pode instalar explicitamente esse grupo usando:
npm ci --include=devEsse comando instala as dependências previstas no arquivo de versões e inclui as de desenvolvimento. O npm também pode executar scripts de instalação definidos no projeto ou nas dependências. A compilação pode ocorrer por um desses scripts ou por um comando executado depois, conforme a configuração do projeto.
Quando o servidor recebe o JavaScript já gerado, o compilador pode ficar fora da instalação desse servidor. Quando o próprio servidor executa a compilação, ele precisa ter acesso à ferramenta durante essa etapa. O nome do ambiente não determina essa necessidade.
A classificação também não funciona como um filtro do conteúdo distribuído. Uma ferramenta de geração pode incluir código importado de uma dev dependency nos arquivos finais. Para conferir o que chegou à aplicação, você precisa examinar as importações e a saída da ferramenta utilizada.
Dúvidas frequentes
Perguntas frequentes sobre dev-dependency
- Como adicionar uma dependência de desenvolvimento?
- Use npm install --save-dev seguido do nome do pacote na pasta do projeto. O npm registra a dependência em devDependencies no package.json.
- O servidor de produção pode precisar dessas dependências?
- Sim, quando ele também gera a aplicação ou executa testes. Um servidor que recebe somente a saída pronta pode dispensá-las, conforme o que essa saída precisa para funcionar.
- Declarar devDependency impede a distribuição do código do pacote?
- A classificação orienta a instalação pelo npm. A inclusão de código nos arquivos distribuídos depende das importações e da ferramenta de geração, por isso você precisa examinar a saída produzida.
Para continuar
Recursos relacionados
Documentação
npm: dependências de desenvolvimento
Documenta o campo devDependencies e o uso de ferramentas de compilação na preparação de um pacote.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação ao vivo para revisar as dependências do projeto e investigar falhas na instalação ou na geração da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver com agentes, você precisa conferir quais ferramentas geram a aplicação e quais dependências a versão publicada utiliza.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.