Cria um package.json; npm init é outra coisa: baixa e roda create- , como o npx faz.

npm init [-y] | npm init — os colchetes marcam o que você pode omitir.

npm init

Pacotes e runtimes

Uso

npm init [-y] | npm init <initializer>

Cria um package.json; npm init <nome> é outra coisa: baixa e roda create-<nome>, como o npx faz.

Opções comuns

Opção	Significado
-y	accept every default and write package.json at once
<initializer>	download and run create-<initializer> instead
--scope=@me	create a scoped package name
-w <dir>	create a workspace package under that directory

Exemplos

npm init -y

writes a package.json with defaults, no questions

npm init vite@latest my-app

runs create-vite; nothing like plain npm init

npm init --scope=@me -y

names the package @me/whatever

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.

Q. O que npm init faz?

Cria um package.json; npm init <nome> é outra coisa: baixa e roda create-<nome>, como o npx faz.

Q. Como se digita?

npm init [-y] | npm init <initializer> — os colchetes marcam o que você pode omitir.

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

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

página man: man npm-init