npm init [-y] | npm init — los corchetes marcan lo que puedes omitir.

npm init

Paquetes y entornos

Uso

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

Crea un package.json; npm init <nombre> es otra cosa: descarga y ejecuta create-<nombre>, como hace npx.

Opciones habituales

Opción	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

Ejemplos

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

La pregunta siempre es qué va dónde: dentro de este proyecto o en todo el sistema.

Cómo leerlo

Los corchetes [ ] marcan una parte que puedes omitir.
Los puntos suspensivos … indican que puedes poner varios.
Las opciones distinguen mayúsculas: en algunos comandos -r y -R no hacen lo mismo.

Q. ¿Qué hace npm init?

Crea un package.json; npm init <nombre> es otra cosa: descarga y ejecuta create-<nombre>, como hace npx.

Q. ¿Cómo se escribe?

npm init [-y] | npm init <initializer> — los corchetes marcan lo que puedes omitir.

Q. ¿Cuántas opciones vale la pena saber?

Aquí van 4; la lista completa está en man npm. Este comando está en Paquetes y entornos.

página man: man npm-init