Τρόπος αντιμετώπισης προβλημάτων και επιδιόρθωσης εγκαταστάσεων Node.js και npm σε Windows και macOS

Αν έχετε προσπαθήσει ποτέ να ξεκινήσετε ένα έργο και διαπιστώσετε ότι το τερματικό δεν αναγνωρίζει εντολές ή ότι τα παγκόσμια πακέτα έχουν χαθεί, μην πανικοβάλλεστε. Είναι πιο συνηθισμένο από ό,τι νομίζετε. Εγκαταστάσεις Node.js και npm Καταστρέφονται ή προκαλούν προβλήματα, ειδικά όταν μεταβαίνουμε από τη μία έκδοση στην άλλη ή όταν τα δικαιώματα του λειτουργικού συστήματος γίνονται ιδιόμορφα.

Για να βάλουμε τάξη σε αυτό το χάος, το πρώτο πράγμα που πρέπει να καταλάβουμε είναι ότι το Node.js είναι το περιβάλλον που σας επιτρέπει να εκτελείτε JavaScript εκτός του προγράμματος περιήγησης, ενώ το npm είναι υπεύθυνο για τη διαχείριση όλων των βιβλιοθηκών. Όταν αυτά τα δύο δεν ταιριάζουν, η καλύτερη προσέγγιση δεν είναι να προσπαθήσετε να "επιδιορθώσετε" την τρέχουσα εγκατάσταση, αλλά μάλλον εφαρμόστε ένα βαθύ καθάρισμα και επανεγκαταστήστε χρησιμοποιώντας εργαλεία που αποτρέπουν την επανεμφάνιση του προβλήματος στο μέλλον.

Επιλέγοντας τη σωστή έκδοση: LTS ή Current;

Πριν ξεκινήσετε την επισκευή, πρέπει να αποφασίσετε ποια διαδρομή θα ακολουθήσετε. Η έκδοση LTS (Μακροπρόθεσμη Υποστήριξη) Είναι η πιο ασφαλής επιλογή. Είναι αυτή που πρέπει να χρησιμοποιήσετε αν ψάχνετε για απόλυτη σταθερότητα στην παραγωγή ή αν μόλις ξεκινάτε, καθώς έχει δοκιμαστεί εκτενώς και σπάνια προκαλεί εκπλήξεις.

Από την άλλη, έχουμε την έκδοση ΡεύμαΑυτή είναι η «αιχμή», όπου φτάνουν τα νεότερα χαρακτηριστικά. Είναι ιδανικό για πειραματισμό ή αν χρειάζεστε ένα χαρακτηριστικό αιχμής από ένα framework, αλλά να έχετε κατά νου ότι η υποστήριξη είναι μικρότερη και εδώ τείνουν να εμφανίζονται περισσότερα σφάλματα. σφάλματα ή ασυμβατότητες με παλαιότερα πακέτα.

Επισκευή και εγκατάσταση στα Windows 11

Όταν το Node.js αποτυγχάνει στα Windows, αυτό συχνά οφείλεται σε πρόβλημα διαδρομής. Εάν χρησιμοποιήσατε το επίσημο πρόγραμμα εγκατάστασης .msi, βεβαιωθείτε ότι η επιλογή [εισαγωγή επιλογής εδώ] ήταν επιλεγμένη κατά τη διάρκεια της διαδικασίας. προσθήκη κόμβου στο PATHΕάν εξακολουθεί να μην λειτουργεί, θα πρέπει να μεταβείτε χειροκίνητα στις Ιδιότητες συστήματος και να προσθέσετε τις διαδρομές προς y %AppData%\npm στις μεταβλητές περιβάλλοντος χρήστη.

Αν προτιμάτε κάτι πιο μοντέρνο και καθαρό, σας προτείνω να χρησιμοποιήσετε φτερωτόςτο οποίο είναι ήδη ενσωματωμένο στα Windows 10 και 11. Με μια απλή εντολή όπως Μπορείτε να τα προετοιμάσετε όλα χωρίς επιπλοκές. Υπάρχει επίσης το Chocolatey, μια πολύ ισχυρή εναλλακτική λύση για όσους αγαπούν το αυτοματοποίηση πακέτων μέσω της γραμμής εντολών.

Για όσους θέλουν να αποφύγουν προβλήματα δικαιωμάτων και να αλλάξουν εκδόσεις χωρίς να προκαλέσουν προβλήματα, η λύση ονομάζεται nvm-windowsΕίναι ένα διαφορετικό έργο από αυτό για Linux/Mac που σας επιτρέπει να εγκαταστήσετε πολλαπλές εκδόσεις του Node και να κάνετε εναλλαγή μεταξύ τους με αποτρέποντας την αστάθεια των παγκόσμιων εργαλείων.

Λύσεις για περιβάλλοντα macOS και Unix

Σε Mac, ο πιο συνηθισμένος τρόπος είναι να χρησιμοποιήσετε το επίσημο πακέτο .pkg, αλλά αν θέλετε να αναβαθμίσετε τη ροή εργασίας σας, Το Homebrew είναι το εργαλείο οριστικό. Επιτρέπει την εγκατάσταση του Node με και να το διατηρείτε εύκολα ενημερωμένο με ένα Ωστόσο, μερικές φορές ενδέχεται να υπάρχουν διενέξεις συνδέσμων που επιλύονται με την εντολή .

Ωστόσο, το πραγματικό «άγιο δισκοπότηρο» στο macOS είναι nvm (Διαχείριση εκδόσεων κόμβου)Εγκαθιστώντας το Node μέσω nvm, τα αρχεία αποθηκεύονται στον φάκελο χρήστη σας και όχι σε περιορισμένους καταλόγους συστήματος. Αυτό λύνει πλήρως το τρομερό πρόβλημα. Σφάλματα δικαιωμάτων EACCES, εξαλείφοντας την ανάγκη χρήσης της εντολής για να εγκαταστήσετε καθολικά πακέτα.

Αν χρησιμοποιείτε Linux (Ubuntu, Debian ή Fedora), είναι καλύτερο να χρησιμοποιήσετε τα σενάρια του NodeSource Για να λάβετε ενημερωμένες εκδόσεις LTS. Να θυμάστε ότι εάν χρησιμοποιείτε WSL (Υποσύστημα Windows για Linux), είναι καλύτερο να εγκαταστήσετε το Node απευθείας μέσα στην διανομή Linux και να μην αναμίξετε το δυαδικό αρχείο των Windows με το δυαδικό αρχείο WSL, καθώς αυτό θα μπορούσε να προκαλέσει προβλήματα. διενέξεις διαδρομής αρκετά ενοχλητικό.

Αντιμετώπιση συνηθισμένων σφαλμάτων και συντήρηση

Αν κατά τη γραφή Το τερματικό θα σας ενημερώσει ότι η εντολή δεν αναγνωρίζεται. Μην πανικοβάλλεστε. Συνήθως σημαίνει ότι η παγκόσμιος κατάλογος δοχείων npm Δεν βρίσκεται στη ΔΙΑΔΡΟΜΗ σας. Σε macOS και Linux, ελέγξτε ότι το αρχείο σας o φορτώνει σωστά τη διαμόρφωση nvm κατά τη σύνδεση, αποτρέποντας έτσι το Το localhost αρνήθηκε να συνδεθεί. ή παρόμοιες βλάβες τοπικού διακομιστή.

Για να διατηρήσετε ένα υγιές περιβάλλον, δεν αρκεί απλώς να το εγκαταστήσετε και να το ξεχάσετε. Η εφαρμογή είναι απαραίτητη. περιστασιακά για να εντοπίσω ευπάθειες ασφαλείας στο τμήμα σας. Αν δείτε ότι κάτι είναι ξεπερασμένο, Θα σας πει ποια πακέτα χρειάζονται επείγουσα ενημέρωση.

Ένα κόλπο για τους προγραμματιστές είναι να χρησιμοποιήσουν npxΑντί να γεμίζει το σύστημά σας με καθολικές εγκαταστάσεις που ενδέχεται να έρχονται σε διένεξη μεταξύ τους, το npx σάς επιτρέπει να εκτελείτε προσωρινά CLI. Επιπλέον, εάν χρειάζεται να διαχειριστείτε το pnpm ή το Yarn, ενεργοποιήστε το Corepack με την εντολή να έχει τον πλήρη έλεγχο των διαχειριστών πακέτων.

Για να αφήσετε το σύστημα καθαρό πριν από την επανεγκατάσταση, στα Windows πρέπει όχι μόνο να διαγράψετε την εφαρμογή από τις ρυθμίσεις, αλλά και να διαγράψετε χειροκίνητα τους υπολειπόμενους φακέλους στο Σε Mac, αν χρησιμοποιούσατε το Homebrew, ένα είναι συνήθως επαρκής, αν και ο καθαρισμός του προσωρινή μνήμη npm με Είναι πάντα καλή ιδέα να αποτρέπετε την επανάληψη παλιών λαθών.

Η διατήρηση ενός υγιούς περιβάλλοντος ανάπτυξης περιλαμβάνει την ιεράρχηση των εκδόσεων LTS, την ανάθεση του ελέγχου εκδόσεων σε εργαλεία όπως το NVM ή το FNM και την αποφυγή της χρήσης δικαιωμάτων διαχειριστή για την εγκατάσταση βιβλιοθηκών με κάθε κόστος. Ρυθμίζοντας σωστά τις μεταβλητές περιβάλλοντος και καθαρίζοντας τα προσωρινά αρχεία, μπορούμε να διασφαλίσουμε ότι τα Node.js και npm λειτουργούν ομαλά σε οποιοδήποτε λειτουργικό σύστημα.

Σχετικό άρθρο:

Διορθώστε το σφάλμα Localhost Refused to Connect to Connect στα Windows

Ισαάκ

Παθιασμένος συγγραφέας για τον κόσμο των byte και της τεχνολογίας γενικότερα. Μου αρέσει να μοιράζομαι τις γνώσεις μου μέσω της γραφής, και αυτό θα κάνω σε αυτό το blog, θα σας δείξω όλα τα πιο ενδιαφέροντα πράγματα σχετικά με τα gadget, το λογισμικό, το υλικό, τις τεχνολογικές τάσεις και πολλά άλλα. Στόχος μου είναι να σας βοηθήσω να περιηγηθείτε στον ψηφιακό κόσμο με απλό και διασκεδαστικό τρόπο.