Node.js- ja npm-asennusten vianmääritys ja korjaaminen Windowsissa ja macOS:ssä

Jos olet joskus yrittänyt käynnistää projektia ja huomannut, että pääteohjelma ei tunnista komentoja tai että globaalit paketit ovat menneet sekaisin, älä panikoi. Se on yleisempää kuin luuletkaan. Node.js- ja npm-asennukset Ne vioittuvat tai aiheuttavat ongelmia, varsinkin kun siirrymme versiosta toiseen tai kun käyttöjärjestelmän käyttöoikeuksista tulee nirsoja.

Tämän kaaoksen järjestyksen luomiseksi on ensin ymmärrettävä, että Node.js on ympäristö, joka sallii JavaScriptin suorittamisen selaimen ulkopuolella, kun taas npm vastaa kaikkien kirjastojen hallinnasta. Kun nämä kaksi eivät sovi yhteen, paras lähestymistapa ei ole yrittää "korjata" nykyistä asennusta, vaan pikemminkin puhdista syvältä ja asenna uudelleen käyttämällä työkaluja, jotka estävät ongelman toistumisen tulevaisuudessa.

Oikean version valitseminen: LTS vai Current?

Ennen korjauksen aloittamista sinun on päätettävä, mitä polkua käytät. Versio LTS (pitkäaikainen tuki) Se on varma valinta; sitä kannattaa käyttää, jos etsit täydellistä vakautta tuotannossa tai jos olet vasta aloittamassa, koska se on laajalti testattu eikä juurikaan aiheuta yllätyksiä.

Toisaalta meillä on versio NykyinenTämä on "etulinja", josta uusimmat ominaisuudet tulevat. Se on loistava kokeiluun tai jos tarvitset huippuluokan ominaisuutta kehyksestä, mutta muista, että tuki on lyhyempi ja tässä esiintyy yleensä enemmän virheitä. bugeja tai yhteensopimattomuutta vanhempien pakettien kanssa.

Korjaus ja asennus Windows 11:ssä

Kun Node.js epäonnistuu Windowsissa, se johtuu usein polkuongelmasta. Jos käytit virallista .msi-asennusohjelmaa, varmista, että vaihtoehto [lisää vaihtoehto tähän] on valittuna prosessin aikana. lisää solmu polkuunJos se ei vieläkään toimi, sinun on manuaalisesti mentävä Järjestelmän ominaisuudet -valikkoon ja lisättävä polut kohteeseen y %AppData%\npm käyttäjäympäristömuuttujissa.

Jos pidät jostain modernimmasta ja siistimmästä, suosittelen käyttämään Wingetjoka on jo integroitu Windows 10:een ja 11:een. Yksinkertaisella komennolla, kuten Voit saada kaiken valmiiksi ilman komplikaatioita. Saatavilla on myös Chocolatey, erittäin vankka vaihtoehto niille, jotka rakastavat pakettiautomaatio komentorivin kautta.

Niille, jotka haluavat välttää käyttöoikeusongelmia ja muuttaa versioita rikkomatta mitään, ratkaisu on nimeltään nvm-windowsSe on eri projekti kuin Linux/Mac-projekti, jonka avulla voit asentaa useita Node-versioita ja vaihtaa niiden välillä estämällä globaalien työkalujen epävakauden.

Ratkaisuja macOS- ja Unix-ympäristöihin

Macilla yleisin tapa on käyttää virallista .pkg-pakettia, mutta jos haluat viedä työnkulkusi seuraavalle tasolle, Kotiolut on työkalu lopullinen. Mahdollistaa Solmun asentamisen ja pidä se helposti ajan tasalla Joskus kuitenkin voi esiintyä linkkiristiriitoja, jotka ratkaistaan ​​komennolla .

macOS:n todellinen "pyhä Graali" on kuitenkin nvm (solmun versionhallinta)Asentamalla Noden nvm:n kautta tiedostot tallennetaan käyttäjäkansioosi eivätkä rajoitettuihin järjestelmähakemistoihin. Tämä ratkaisee pelätyn ongelman täysin. EACCES-käyttöoikeusvirheet, jolloin komentoa ei tarvitse käyttää globaalien pakettien asentamiseen.

Jos käytät Linuxia (Ubuntu, Debian tai Fedora), on parasta käyttää skriptejä, jotka ovat NodeSource Päivitettyjen LTS-versioiden hankkiminen. Muista, että jos käytät WSL:ää (Windows Subsystem for Linux), on parasta asentaa Node suoraan Linux-jakelussa eikä sekoittaa Windows-binääriä WSL-binäärin kanssa, koska se voi aiheuttaa ongelmia. reittikonfliktit aika ärsyttävää.

Yleisten virheiden vianmääritys ja huolto

Jos kirjoittaessasi Pääte ilmoittaa, että komentoa ei tunnisteta; älä hätäänny. Yleensä se tarkoittaa, että npm:n globaali bin-hakemisto Se ei ole PATH-polussasi. Tarkista macOS:ssä ja Linuxissa, että tiedostosi o lataa nvm-kokoonpanon oikein kirjautumisen yhteydessä, mikä estää localhost kieltäytyi muodostamasta yhteyttä tai vastaavia paikallisia palvelinongelmia.

Terveellisen ympäristön ylläpitämiseksi ei riitä, että vain asentaa ja unohtaa sen. Toteutus on välttämätöntä. satunnaisesti havaitakseen tietoturva-aukkoja osastollasi. Jos huomaat, että jokin on vanhentunutta, Se kertoo, mitkä paketit tarvitsevat kiireellisen päivityksen.

Yksi kehittäjien temppu on käyttää npxSen sijaan, että täyttäisit järjestelmäsi globaaleilla asennuksilla, jotka voivat olla ristiriidassa keskenään, npx antaa sinun suorittaa komentoriviltäsi tilapäisesti. Lisäksi, jos sinun on hallittava pnpm:ää tai Yarnia, ota käyttöön Corepack komennolla saada täydellinen hallinta pakettien hallintaohjelmiin.

Jotta järjestelmä pysyisi puhtaana ennen uudelleenasennusta Windowsissa, sinun on paitsi poistettava sovellus asetuksista, myös poistettava manuaalisesti jäljellä olevat kansiot Macilla, jos käytit Homebrewia, yleensä riittää, vaikka puhdistaminen npm-välimuisti kanssa On aina hyvä estää vanhojen virheiden toistuminen.

Terveen kehitysympäristön ylläpitäminen edellyttää LTS-versioiden priorisointia, versionhallinnan delegointia työkaluille, kuten NVM tai FNM, ja järjestelmänvalvojan oikeuksien käytön välttämistä kirjastojen asentamiseen hinnalla millä hyvänsä. Konfiguroimalla ympäristömuuttujat oikein ja tyhjentämällä väliaikaistiedostot voimme varmistaa, että Node.js ja npm toimivat sujuvasti missä tahansa käyttöjärjestelmässä.

Aiheeseen liittyvä artikkeli:

Korjaa Localhost kieltäytyi muodostamasta yhteyttä -virhe Windowsissa

Isaac

Intohimoinen kirjoittaja tavujen maailmasta ja tekniikasta yleensä. Rakastan jakaa tietämykseni kirjoittamalla, ja sen aion tehdä tässä blogissa, näyttää sinulle kaikki mielenkiintoisimmat asiat vempaimista, ohjelmistoista, laitteistoista, teknologisista trendeistä ja muusta. Tavoitteeni on auttaa sinua navigoimaan digitaalisessa maailmassa yksinkertaisella ja viihdyttävällä tavalla.