Installazione e Configurazione di Node.js e npm: Guida Completa

Codegrind Team•Aug 28 2024

Node.js è una piattaforma runtime basata su JavaScript che permette di eseguire codice JavaScript lato server. È molto popolare per lo sviluppo di applicazioni web, API e servizi backend. npm (Node Package Manager) è il gestore di pacchetti per Node.js, utilizzato per installare e gestire le dipendenze del progetto. In questa guida, esploreremo come installare e configurare Node.js e npm su diversi sistemi operativi, e come preparare l’ambiente di sviluppo per avviare progetti con Node.js.

Installazione di Node.js e npm

Installazione su Windows

Scaricare il Pacchetto di Installazione

Vai al sito ufficiale di Node.js e scarica il pacchetto di installazione per Windows. Assicurati di scaricare la versione LTS (Long Term Support) per maggiore stabilità.
Eseguire il Programma di Installazione

Avvia il programma di installazione e segui le istruzioni a schermo. Durante l’installazione, seleziona l’opzione per installare npm automaticamente.
Verificare l’Installazione

Dopo l’installazione, apri il prompt dei comandi e digita:
```
node -v
npm -v
```
Dovresti vedere la versione di Node.js e npm installata.

Installazione su macOS

Installare Homebrew

Homebrew è un gestore di pacchetti per macOS che facilita l’installazione di software. Se non l’hai già installato, esegui il seguente comando nel terminale:
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Installare Node.js e npm

Usa Homebrew per installare Node.js e npm:
```
brew install node
```
Verificare l’Installazione

Dopo l’installazione, verifica la versione di Node.js e npm:
```
node -v
npm -v
```

Installazione su Linux

Debian/Ubuntu

Aggiornare il Sistema

Esegui l’aggiornamento dei pacchetti di sistema:
```
sudo apt update
sudo apt upgrade
```
Aggiungere il Repository Node.js

Aggiungi il repository NodeSource per installare Node.js:
```
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
```
Installare Node.js e npm

Installa Node.js e npm:
```
sudo apt install -y nodejs
```
Verificare l’Installazione

Verifica la versione di Node.js e npm:
```
node -v
npm -v
```

Red Hat/CentOS

Installare Node.js e npm

Usa il gestore di pacchetti yum per installare Node.js:

curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs

Verificare l’Installazione

Verifica la versione di Node.js e npm:
```
node -v
npm -v
```

Configurazione dell’Ambiente di Sviluppo

Configurare un Progetto Node.js

Creare una Cartella di Progetto

Crea una cartella per il tuo progetto Node.js:
```
mkdir mio-progetto-node
cd mio-progetto-node
```
Inizializzare il Progetto con npm

Inizializza un nuovo progetto Node.js con npm:
```
npm init
```
Segui le istruzioni per impostare il package.json, che conterrà le informazioni sul progetto e le dipendenze.

Installare Moduli e Dipendenze

Usa npm per installare moduli e dipendenze necessarie per il tuo progetto:

npm install express

Questo comando installa il modulo Express, un framework web popolare per Node.js, e aggiunge la dipendenza al file package.json.

Configurare lo Script di Avvio

Nel file package.json, puoi definire script personalizzati per eseguire il tuo progetto. Ad esempio, puoi aggiungere uno script di avvio:

{
  "name": "mio-progetto-node",
  "version": "1.0.0",
  "scripts": {
    "start": "node app.js"
  },
  "dependencies": {
    "express": "^4.17.1"
  }
}

Questo script eseguirà il file app.js quando lanci npm start.

Configurare Variabili d’Ambiente

Le variabili d’ambiente sono utilizzate per configurare il comportamento dell’applicazione senza modificare il codice sorgente. Puoi utilizzare il modulo dotenv per gestire facilmente le variabili d’ambiente:

Installare dotenv
```
npm install dotenv
```
Creare un File .env

Crea un file .env nella radice del progetto:
```
touch .env
```
Definire le Variabili d’Ambiente

Aggiungi le tue variabili d’ambiente al file .env:
```
PORT=3000
DATABASE_URL=mongodb://localhost:27017/miodb
```

Utilizzare le Variabili d’Ambiente nel Codice

Usa queste variabili nel tuo codice Node.js:

require("dotenv").config();

const express = require("express");
const app = express();

const port = process.env.PORT || 3000;

app.listen(port, () => {
  console.log(`Server in ascolto sulla porta ${port}`);
});

Aggiornamento di Node.js e npm

Aggiornare npm

Per aggiornare npm alla versione più recente:

npm install -g npm

Aggiornare Node.js

L’aggiornamento di Node.js dipende dal sistema operativo. Su macOS e Linux, puoi utilizzare il gestore di versioni n:

Installare n
```
npm install -g n
```
Installare l’Ultima Versione di Node.js
```
n latest
```
Installare una Versione Specifica di Node.js
```
n 14.17.0
```

Risolvere Problemi Comuni

Node.js non Viene Riconosciuto

Se il comando node non viene riconosciuto, verifica che Node.js sia stato installato correttamente e che la variabile di ambiente PATH includa il percorso di Node.js.

Moduli npm non Vengono Installati

Se npm non riesce a installare i moduli, prova a cancellare la cache di npm:

npm cache clean --force

Se il problema persiste, potrebbe essere necessario reinstallare Node.js e npm.

Problemi di Permessi

Su Linux e macOS, potresti incontrare problemi di permessi durante l’installazione globale di pacchetti npm. Una soluzione è utilizzare nvm (Node Version Manager), che gestisce le versioni di Node.js e npm per ciascun utente.

Conclusione

L’installazione e la configurazione di Node.js e npm è un passo fondamentale per iniziare a sviluppare applicazioni web moderne. Seguendo questa guida, puoi configurare correttamente il tuo ambiente di sviluppo e prepararti a creare applicazioni robuste e scalabili con Node.js. Assicurati di mantenere aggiornati Node.js e npm per beneficiare delle ultime funzionalità e miglioramenti in termini di sicurezza.