Início·Comandos de terminal

npx

Pacotes e runtimes

Uso

npx [-y] <package>[@version] [args...]

Executa o binário de um pacote, preferindo node_modules/.bin e baixando-o temporariamente se faltar; como um erro de digitação pode trazer um pacote alheio, --no restringe ao que é local.

Opções comuns

OpçãoSignificado
-yinstall without asking first
--nofail instead of downloading anything
-p <pkg>make a package available, then run a command from it
-c "<cmd>"run the command through a shell with the bin path set
--package <pkg>the long form of -p

Exemplos

npx tsc --noEmit

runs the typescript in node_modules, no global install

npx -y create-next-app@latest my-app

fetches a scaffolder for one use and forgets it

npx --no eslint .

uses the local eslint or fails, instead of quietly downloading one

A pergunta é sempre o que vai onde: dentro deste projeto ou na máquina toda.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que npx faz?

Executa o binário de um pacote, preferindo node_modules/.bin e baixando-o temporariamente se faltar; como um erro de digitação pode trazer um pacote alheio, --no restringe ao que é local.

Q. Como se digita?

npx [-y] <package>[@version] [args...] — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 5; a lista completa está em man npx. Este comando fica em Pacotes e runtimes.

Comandos relacionados

página man: man npx