Node.js:n asennus: Windows, macOS ja Linux

01Mikä on Node.js ja miksi se asennetaan?

Node.js on suoritusympäristö, joka ajaa JavaScriptiä selaimen ulkopuolella, suoraan tietokoneellasi tai palvelimella. Lähes kaikki modernit verkkoprojektit tarvitsevat Node.js:ää kehityksen aikana: pakettien asennus, käännös ja paikallisen kehityspalvelimen avaaminen tehdään sillä.

Vaikka et käyttäisi työkaluja kuten React, Vite, Next.js tai Tailwind, ensimmäinen vastaan tuleva vaihe projektia tietokoneellasi ajaessasi on yleensä npm install. Tämä komento kuuluu Node.js:n mukana tulevalle pakettienhallinnalle npm:lle; eli ilman Node.js:n asennusta et pääse tämän vaiheen yli.

Tässä oppaassa käsittelemme kaksi tapaa: virallinen asennusohjelma niille, jotka työskentelevät yhden version kanssa, ja versionhallinta niille, jotka työskentelevät useiden projektien kanssa. Alla oleva taulukko selkeyttää, kumman valitset.

02Mitä tarvitaan ennen asennusta?

Node.js on kevyt asennettava, mutta muutama esivalmistelu estää myöhemmät ongelmat. Erityisesti jos tietokoneellasi on jo vanha Node.js, nvm:n asentaminen poistamatta sitä voi aiheuttaa PATH-ristiriidan.

Kiinnitä huomiota myös prosessoriarkkitehtuuriin. Apple Siliconin (M-sarja) Maceissa ja ARM-pohjaisissa Windows-laitteissa asennusohjelma yleensä valitsee oikean arkkitehtuurin itse; jos lataat käsin, älä sekoita x64- ja ARM64-tiedostoja. Väärän arkkitehtuurin asennus hidastuu tai joitakin natiivipaketteja ei voi kääntää, vaikka se toimisikin.

Yrityskoneissa välityspalvelin tai palomuuri voi estää npm:n pakettien latauksen. Jos olet tällaisessa verkossa, pyydä IT-tiimiltäsi ennen asennusta pääsy npm-rekisteriosoitteeseen (registry.npmjs.org).

• Järjestelmänvalvojan oikeudet: Tarvitaan Windowsissa ja macOS:ssä virallista asennusohjelmaa varten; nvm asennetaan käyttäjän kansioon, joten oikeuksia ei yleensä tarvita.
• Pääte: Windowsissa PowerShell tai Windows Terminal, macOS:ssä Terminal ja Linuxissa oletuskuori riittää.
• Vanhan asennuksen poistaminen: Jos siirryt versionhallintaan, poista ensin nykyinen Node.js kohdasta Asetukset > Sovellukset tai pakettienhallinnan kautta.
• Versiovalinta: Valitse tuotannossa ja oppiessasi LTS (pitkäaikaistuettu) -versio; Current-versio on tarkoitettu niille, jotka haluavat nähdä uudet ominaisuudet ensimmäisinä.

03Node.js:n asennus Windowsissa

Windowsissa on kolme tapaa: virallinen .msi-asennusohjelma, Windowsin oma pakettienhallinta winget ja versionhallintaan nvm-windows. Minkä tahansa valitsetkin, sulje asennuksen jälkeen auki olevat päätteet ja avaa ne uudelleen; muuten uusi PATH-asetus ei näy.

Viralliselle asennusohjelmalla

Lataa nodejs.org-sivustolta Windowsin LTS .msi -tiedosto, aja asennusohjelma ja etene oletusvalinnoilla. Asennusohjelma asentaa Node.js:n mukana myös npm:n ja lisää sen PATH-muuttujaan automaattisesti.

wingetillä

Windows 10:ssä ja 11:ssä mukana tulevalla wingetillä voit asentaa LTS-version yhdellä komennolla:

winget install OpenJS.NodeJS.LTS

nvm-windowsilla

Jos tarvitset useita versioita, asenna nvm-windows; se on macOS:n ja Linuxin nvm:stä erillinen projekti, mutta komennot ovat samankaltaisia. Avaa asennuksen jälkeen PowerShell järjestelmänvalvojana ja aja seuraavat komennot:

winget install CoreyButler.NVMforWindows

# Sulje pääte ja avaa se uudelleen
nvm install lts
nvm use lts
nvm list

04Asennus nvm:llä macOS:ssä ja Linuxissa

macOS:ssä ja Linuxissa luotettavin tapa on käyttää nvm:ää (Node Version Manager). nvm asentaa Node.js:n käyttäjäkansioosi; näin sinun ei tarvitse käyttää sudoa globaaleja paketteja asentaessasi etkä joudu kamppailemaan käyttöoikeusvirheiden kanssa.

Alla oleva komento lataa ja ajaa nvm:n asennusskriptin. Virallinen README suosittelee versiotunnisteella varustettua osoitetta; kaikkein varminta on kopioida ajantasaisin komento nvm:n GitHub-sivulta.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# Lataa komentotulkki uudelleen (valitse käyttämäsi mukaan)
source ~/.bashrc
source ~/.zshrc

# Tarkista, että nvm on asentunut
command -v nvm

nvm install --lts
nvm use --lts
nvm alias default 'lts/*'

Asennus Homebrewlla macOS:ssä

Jos käytät Homebrewta, myös komento brew install node käy. Se kuitenkin asentaa yleensä uusimman version; jos haluat pysyä LTS:ssä, nvm on joustavampi.

brew install node

Linux-jakelujen varastot

Ubuntussa tai Debianissa komento sudo apt install nodejs npm toimii, mutta varaston versio on usein vanhempi kuin ajantasaiset projektit vaativat. Siksi suosittelemme kehityskoneilla nvm:ää.

05Miten varmistan asennuksen?

Kun asennus on valmis, avaa uusi pääte ja aja seuraavat komennot. Kummankin komennon tulee palauttaa versionumero. Näet sen jälkeen pienellä testiskriptillä, että Node.js ajaa koodia.

• node -v -komennon tuloste on v-kirjaimella alkava versionumero.
• npm -v palauttaa pelkkiä numeroita; npm tulee Node.js:n mukana.
• Jos testikomento kirjoittaa viestin näytölle, ympäristösi on valmis; seuraavana on pakettienhallinta npm-komennoilla.

node -v
npm -v
node -e "console.log('Node.js toimii')"

06Miten Node-versiota vaihdetaan?

Eri projektit voivat vaatia eri Node.js-versioita: vanha projekti toimii vanhalla versiolla ja uusi ajantasaisella LTS:llä. Node-version vaihtaminen kestää nvm:llä muutaman sekunnin.

Jos asetat projektin juurikansioon .nvmrc-tiedoston, kaikki tiimissä käyttävät samaa versiota. Riittää, että menet kansioon ja kirjoitat nvm use; näin siirrytään tiedostossa olevaan versioon (nvm-windows ei lue .nvmrc-tiedostoa; siellä versio kirjoitetaan käsin).

# Asennetut versiot
nvm ls

# Etäpalvelimen LTS-versiot
nvm ls-remote --lts

# Asenna tietty pääversio ja siirry siihen (esimerkki)
nvm install 20
nvm use 20

# Tallenna projektissa käytettävä versio
node -v > .nvmrc
nvm use

07Yleiset virheet ja ratkaisut

Suurin osa Node.js:n asennuksen ongelmista liittyy PATH-muuttujaan ja käyttöoikeuksiin. Alla oleva lista tiivistää yleisimmin näkemämme virheet ja nopeat ratkaisut.

node-komentoa ei tunnisteta

Windowsissa ”node is not recognized” -virhe johtuu yleensä siitä, että pääte on avattu ennen asennusta. Sulje kaikki päätteet ja VS Code ja avaa ne uudelleen; jos ongelma jatkuu, tarkista, onko Node.js-kansio PATH-muuttujassa.

PowerShellin skriptiesto

PowerShell voi kieltäytyä ajamasta npm.ps1-tiedostoa. Ongelma ratkeaa lieventämällä suoritusohjetta vain omalle käyttäjällesi:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

EACCES-käyttöoikeusvirhe

Jos saat macOS:ssä tai Linuxissa komennon npm install -g aikana EACCES-virheen, Node.js on asennettu järjestelmäkansioon. Älä aja npm:ää sudolla; poista nykyinen asennus ja asenna uudelleen nvm:llä.

nvm: command not found

Asennusskripti lisää nvm-rivit kuoriprofiiliisi, mutta auki oleva pääte ei tiedä siitä. Aja source ~/.zshrc tai source ~/.bashrc tai avaa pääte uudelleen.

08Mitä asennuksen jälkeen kannattaa tehdä?

Kun Node.js on valmis, viimeistele kehitysympäristön loppuosa: editoria varten katso oppaamme VS Coden asennus ja koodin varmuuskopiointia ja jakamista varten projektin lataaminen GitHubiin. Kaikki vaihe vaiheelta -oppaat löytyvät asennusoppaat-kategoriasta.

Jos kehität yritykselle verkkoprojektia, Node.js-pohjaiset työkalut pienentävät käännöksen aikana kuvia, CSS:ää ja JavaScriptiä ja edistävät suoraan sivun nopeutta. Käsittelemme tätä yksityiskohtaisesti nopeus- ja suorituskykyoptimointi -palvelussamme.

Jos sinulla ei ole omaa tiimiä tai projektisi vaatii laajan järjestelmän, kuten verkkokauppa-alustan, asennuksen ja kehityksen jättäminen asiantuntijatiimille säästää aikaa. Yrityksen kotisivu- ja verkkokauppa-alusta -projekteissa pystytämme koko ympäristön, ja sinä keskityt vain sisältöön.