Ar npm neveikia? Tiesioginė būsena ir sutrikimų pranešimai

Paslaugos informacija ir trikčių šalinimas

npm neįdiegia paketų

Dažniausia problema – paketo įdiegimas sustoja arba baigiasi klaida. Pirmiausia patikrinkite Node.js versiją: komanda node -v parodys, ką turite sistemoje. Jei versija per sena, dalis šiuolaikinių paketų tiesiog atsisakys įsidiegti. Atnaujinkite Node.js per oficialų diegimo paketą arba nvm įrankį, tada bandykite iš naujo.

Paketo versija nesuderinama su projektu

Kai npm praneša apie versijų konfliktą, problema dažniausiai slypi package.json faile. Patikrinkite, ar nurodyti versijų diapazonai neprieštarauja vienas kitam. Komanda npm ls padės pamatyti, kaip paketai priklausomi vienas nuo kito. Jei konfliktas neišsprendžiamas automatiškai, išbandykite npm install su vėliavėle --legacy-peer-deps – tai leidžia ignoruoti kai kuriuos nesuderinamumo įspėjimus.

Registro serveris nepasiekiamas

Jei npm negali susisiekti su registro serveriu, pirmiausia patikrinkite interneto ryšį. Tada paleiskite npm ping – ši komanda patikrins, ar registras atsiliepia. Jei atsakymo nėra, problema gali būti laikina serverio perkrova. Palaukite kelias minutes ir bandykite dar kartą.

Kešas sugadintas, paketai neatsiunčiami

Sugadintas lokalus kešas – dažna priežastis, kodėl atsisiuntimas sustoja pusiau arba paketas įdiegiamas neteisingai. Išvalykite kešą komanda npm cache clean --force, tada pakartokite diegimą.

Leidimų klaidos diegiant globaliai

• Naudokite nvm, kad išvengtumėte sisteminių leidimų problemų
• Nekeiskite sisteminių aplankų prieigos teisių rankiniu būdu
• Jei reikia globalaus diegimo, sukonfigūruokite npm naudoti vartotojo aplanką komanda npm config set prefix

Užšalęs terminalas vykdant komandą

Kartais npm komanda tiesiog sustoja ir nieko nedaro – terminalas nereaguoja. Tai gali nutikti dėl tinklo skirtojo laiko arba didelio paketo. Paspauskite Ctrl+C, kad nutrauktumėte procesą, ir bandykite pridėti --verbose vėliavėlę – taip matysite, kuriame žingsnyje viskas sustoja. Dažnai pakanka pakeisti tinklo ryšį arba palaukti, kol serverio apkrova sumažės.

Nepavyksta prisijungti prie privačios saugyklos

• Patikrinkite, ar .npmrc faile nurodytas teisingas autentifikavimo prieigos raktas
• Įsitikinkite, kad raktas nepasibaikė – kai kurie organizaciniai raktai turi galiojimo laiką
• Paleiskite npm whoami, kad pamatytumėte, ar sistema jus atpažįsta

Paketų užrakinimo failas sukelia konfliktus

Kai keletas kūrėjų dirba su tuo pačiu projektu, package-lock.json dažnai sukelia sujungimo konfliktus. Nereikia šio failo redaguoti rankiniu būdu – geriausia ištrinti jį ir node_modules aplanką, tada paleisti npm install iš naujo. Taip bus sugeneruotas švarus užrakinimo failas pagal dabartines priklausomybes.