Εντολές npm: οδηγός διαχείρισης πακέτων
Ένας οδηγός βήμα προς βήμα, με παραδείγματα εντολών, για την εγκατάσταση και ενημέρωση πακέτων με το npm, την εκτέλεση scripts και τη διαχείριση του package.json.

Η περισσότερη καθημερινή δουλειά γίνεται με λίγες εντολές npm: το npm init ξεκινά το έργο, το npm install εγκαθιστά τις εξαρτήσεις, το npm install όνομα-πακέτου προσθέτει ένα νέο πακέτο, το npm run όνομα-script εκτελεί ένα script από το package.json και το npm update ενημερώνει τα πακέτα. Το npx εκτελεί ένα εργαλείο μία φορά χωρίς να το εγκαταστήσει και το npm ci κάνει καθαρή εγκατάσταση ακολουθώντας ακριβώς το αρχείο κλειδώματος.
Τι είναι το npm και σε τι χρησιμεύει;
Το npm (Node Package Manager) είναι ο διαχειριστής πακέτων του κόσμου της JavaScript. Σας επιτρέπει να προσθέτετε στο έργο σας βιβλιοθήκες γραμμένες από άλλους, να παρακολουθείτε τις εκδόσεις τους και να εκτελείτε εντολές που αφορούν το έργο από ένα σημείο.
Το npm έρχεται μαζί με το Node.js· δεν χρειάζεται να το εγκαταστήσετε ξεχωριστά. Αν δεν έχετε εγκαταστήσει ακόμη το Node.js, ακολουθήστε πρώτα τον οδηγό μας για την εγκατάσταση του Node.js και μετά δοκιμάστε τις εντολές αυτού του άρθρου στο δικό σας τερματικό.
Το npm έχει τρία μέρη: το εργαλείο γραμμής εντολών στον υπολογιστή σας, το registry όπου φιλοξενούνται τα πακέτα και το αρχείο package.json στην καρδιά κάθε έργου. Σχεδόν κάθε εντολή διαβάζει ή ενημερώνει αυτό το αρχείο.
Τι είναι το package.json;
Το package.json είναι η ταυτότητα του έργου: εδώ γράφονται το όνομά του, η έκδοση, οι εξαρτήσεις και τα scripts που μπορούν να εκτελεστούν. Σε ένα νέο έργο δημιουργείτε αυτό το αρχείο με το npm init· η επιλογή -y παραλείπει όλες τις ερωτήσεις με προεπιλεγμένες απαντήσεις.
- dependencies: Πακέτα που χρειάζεται η εφαρμογή κατά την εκτέλεση.
- devDependencies: Εργαλεία που χρειάζονται μόνο κατά την ανάπτυξη και το build (μεταγλωττιστής, εργαλείο δοκιμών, formatter).
- scripts: Σύντομες εντολές που εκτελούνται με το npm run.
- package-lock.json: Καταγράφει την ακριβή έκδοση κάθε εγκατεστημένου πακέτου· φροντίστε να προσθέσετε αυτό το αρχείο στο Git.
mkdir ilk-proje cd ilk-proje npm init -y{ "name": "ilk-proje", "version": "1.0.0", "scripts": { "dev": "vite", "build": "vite build", "test": "node --test" }, "dependencies": { "axios": "^1.7.0" }, "devDependencies": { "vite": "^6.0.0" } }Εγκατάσταση πακέτων με το npm install
Το npm install είναι η πιο συχνά χρησιμοποιούμενη εντολή και κάνει δύο διαφορετικές δουλειές. Μόνο του, εγκαθιστά όλες τις εξαρτήσεις του package.json στον φάκελο node_modules· με όνομα πακέτου, εγκαθιστά το συγκεκριμένο πακέτο και το προσθέτει στο package.json. Η σύντομη μορφή του είναι npm i.
# Install all dependencies in the project npm install # Yeni paket ekle (dependencies) npm install axios # Add a development tool (devDependencies) npm install -D prettier # Install a specific version npm install lodash@4 # Global install (for command line tools) npm install -g serve # Remove the package npm uninstall axiosΚαθολικά ή τοπικά;
Εγκαθιστάτε τα πακέτα τοπικά όποτε είναι δυνατό, ώστε το έργο να τρέχει με τις ίδιες εκδόσεις σε άλλον υπολογιστή. Κρατήστε τις καθολικές εγκαταστάσεις για εργαλεία γραμμής εντολών που θα χρησιμοποιείτε παντού· για εργαλεία μίας χρήσης αρκεί το npx.
Πότε να χρησιμοποιήσετε το npm ci;
Το npm ci διαγράφει τον φάκελο node_modules, εγκαθιστά τις ακριβείς εκδόσεις του package-lock.json και δεν αλλάζει το αρχείο κλειδώματος. Είναι ιδανικό για ανάπτυξη σε διακομιστή, για pipelines συνεχούς ενσωμάτωσης και για την επίλυση προβλημάτων του τύπου «σε μένα δούλευε».
Εκτέλεση scripts με το npm run
Το πεδίο scripts του package.json σας επιτρέπει να δίνετε σύντομα ονόματα σε μακριές εντολές. Έτσι όλοι στην ομάδα ξεκινούν τον διακομιστή ανάπτυξης με npm run dev και το build παραγωγής με npm run build, χωρίς να γνωρίζουν τις λεπτομέρειες του εργαλείου.
Ορισμένα ονόματα, όπως το start και το test, είναι ειδικά και εκτελούνται χωρίς να γράψετε run. Για να περάσετε επιπλέον παραμέτρους σε ένα script χρησιμοποιούνται δύο παύλες.
npm run dev npm run build npm start npm test # List all defined scripts npm run # Pass a parameter to the script npm run build -- --mode stagingScripts pre και post
Αν προσθέσετε pre ή post μπροστά από το όνομα ενός script, το npm το εκτελεί αυτόματα πριν ή μετά. Για παράδειγμα, ένα script με όνομα prebuild μπορεί να καθαρίσει τον παλιό φάκελο build λίγο πριν από το npm run build. Αυτό το μοτίβο εμποδίζει οποιονδήποτε στην ομάδα να ξεχάσει ένα βήμα.
Γιατί τα scripts βρίσκουν τα τοπικά εργαλεία
Κατά την εκτέλεση, το npm run προσθέτει προσωρινά τον φάκελο node_modules/.bin του έργου στο PATH. Έτσι σε ένα script αρκεί να γράψετε vite ή prettier· δεν χρειάζεται να εγκαταστήσετε το εργαλείο καθολικά. Αν το ίδιο εργαλείο δεν βρίσκεται όταν το πληκτρολογείτε απευθείας στο τερματικό, αυτός είναι ο λόγος και η λύση είναι να χρησιμοποιήσετε το npx.
Διαφορές λειτουργικών συστημάτων στα scripts
Εντολές όπως το rm -rf δεν λειτουργούν στο προεπιλεγμένο κέλυφος των Windows. Αν η ομάδα σας χρησιμοποιεί διαφορετικά λειτουργικά συστήματα, προτιμήστε στα scripts σας εργαλεία Node.js cross-platform ή σύντομα scripts Node.js· έτσι το ίδιο package.json δίνει το ίδιο αποτέλεσμα σε κάθε μηχάνημα.
Ενημέρωση και έλεγχος πακέτων
Τα πακέτα ενημερώνονται τακτικά· κλείνουν κενά ασφαλείας και έρχονται νέες δυνατότητες. Πριν από την ενημέρωση, εκτελέστε την εντολή npm outdated για να δείτε τι έχει παλιώσει.
Το σύμβολο ^ στο package.json επιτρέπει εκδόσεις minor και patch (1.7.0 → 1.9.2) και το σύμβολο ~ επιτρέπει μόνο εκδόσεις patch (1.7.0 → 1.7.5). Το npm update ενημερώνει μέσα σε αυτά τα όρια· για να περάσετε σε νέα major έκδοση πρέπει να εγκαταστήσετε ξανά το πακέτο με @latest και αυτό συνήθως απαιτεί αλλαγές στον κώδικα.
# Eskiyen paketleri listele npm outdated # Update within the allowed range npm update # Move to the next major version (use with care) npm install axios@latest # Security audit npm audit npm audit fix # View installed packages npm ls --depth=0 npm ls -g --depth=0 # The latest published version of a package npm view axios versionΤι είναι το npx και πότε το χρησιμοποιούμε;
Το npx είναι ένας εκτελεστής πακέτων που έρχεται με το npm. Σας επιτρέπει να εκτελέσετε ένα εργαλείο μία φορά χωρίς να το εγκαταστήσετε καθολικά· το εργαλείο αναζητείται πρώτα στο node_modules του έργου και, αν δεν υπάρχει εκεί, κατεβαίνει προσωρινά.
Η δημιουργία ενός προτύπου έργου είναι η πιο συνηθισμένη χρήση του npx. Για παράδειγμα, η εντολή npm create χρησιμοποιείται για να ξεκινήσει ένα νέο έργο React με το Vite· μπορείτε να βρείτε τις λεπτομέρειες στο άρθρο μας εγκατάσταση React με Vite.
# Serve the folder on a local server npx serve . # Run the formatter installed in the project npx prettier --write . # New project from a template (does the same job as npm create, npx create-...) npm create vite@latestnpm έναντι yarn έναντι pnpm
Το npm δεν είναι η μόνη επιλογή· τα yarn και pnpm εγκαθιστούν επίσης πακέτα από το ίδιο registry. Επειδή και τα τρία χρησιμοποιούν το package.json, η δομή του έργου δεν αλλάζει· οι διαφορές φαίνονται στην ταχύτητα εγκατάστασης, στη χρήση δίσκου και στο αρχείο κλειδώματος.
- Χρησιμοποιείτε έναν μόνο διαχειριστή πακέτων σε ένα έργο· δύο αρχεία κλειδώματος ταυτόχρονα οδηγούν σε σύγχυση εκδόσεων.
- Αν μπαίνετε σε ένα υπάρχον έργο, δείτε το αρχείο κλειδώματος στον φάκελο και επιλέξτε το ίδιο εργαλείο.
- Αν μόλις ξεκινάτε, η αρχή με το npm είναι ο δρόμος με τη λιγότερη τριβή.
| Εργαλείο | Αρχείο κλειδώματος | Χαρακτηριστικό πλεονέκτημα |
|---|---|---|
| npm | package-lock.json | Έρχεται με το Node.js, δεν χρειάζεται επιπλέον εγκατάσταση |
| yarn | yarn.lock | Workspaces και διαφορετικοί τρόποι εγκατάστασης |
| pnpm | pnpm-lock.yaml | Εξοικονομεί χώρο στον δίσκο κρατώντας τα πακέτα σε κοινό store |
Συνηθισμένα σφάλματα και λύσεις
Τα περισσότερα σφάλματα του npm προέρχονται από κατεστραμμένη cache, ασύμβατη έκδοση Node.js ή συγκρουόμενες εξαρτήσεις. Διαβάστε πρώτα τις πρώτες γραμμές του μηνύματος σφάλματος· η λύση συνήθως εξηγείται εκεί.
- Σφάλμα ERESOLVE / peer dependency: Ένα από τα πακέτα περιμένει διαφορετική έκδοση ενός άλλου πακέτου. Ενημερώστε τα πακέτα σε συμβατές εκδόσεις· ως προσωρινή λύση μπορεί να χρησιμοποιηθεί το npm install --legacy-peer-deps.
- Κατεστραμμένος node_modules: Διαγράψτε τον φάκελο node_modules και εκτελέστε npm install ή npm ci. Η διαγραφή του αρχείου κλειδώματος είναι η τελευταία λύση.
- Πρόβλημα cache: Το npm cache verify ελέγχει την cache· αν χρειαστεί, καθαρίστε την με npm cache clean --force.
- Σφάλμα δικαιωμάτων EACCES: Μη χρησιμοποιείτε sudo για καθολικές εγκαταστάσεις· εγκαταστήστε ξανά το Node.js με το nvm.
- Προειδοποίηση engine: Αν ένα πακέτο απαιτεί νεότερο Node.js, περάστε στην έκδοση LTS με το nvm.
Σωστή χρήση του npm στα έργα σας
Πολλά πακέτα αυξάνουν τόσο τον κίνδυνο ασφαλείας όσο και την ποσότητα JavaScript που στέλνει μια σελίδα στον browser. Το να αναρωτιέστε «μπορώ να το λύσω με λίγες γραμμές κώδικα;» πριν από κάθε νέα εξάρτηση είναι η φθηνότερη βελτιστοποίηση για την ταχύτητα της σελίδας. Καλύπτουμε τακτικά αυτό το θέμα στην υπηρεσία μας βελτιστοποίηση ταχύτητας και απόδοσης.
Μην προσθέτετε ποτέ τον φάκελο node_modules στο Git· καταχωρίστε τον στο .gitignore και μοιραστείτε μόνο το package.json και το αρχείο κλειδώματος. Εξηγήσαμε βήμα προς βήμα πώς να στείλετε ένα έργο σε απομακρυσμένο αποθετήριο στον οδηγό μας ανέβασμα έργου στο GitHub.
Αν σχεδιάζετε σχεδιασμό ιστοσελίδας για την επιχείρησή σας ή ένα έργο ενοποίησης που συνδέει συστήματα πληρωμών, αποστολών και λογιστικής, το σωστό στήσιμο της διαχείρισης εξαρτήσεων από την αρχή μειώνει το κόστος συντήρησης μακροπρόθεσμα. Για περισσότερο περιεχόμενο για το Node.js, περιηγηθείτε στη σελίδα της ετικέτας nodejs.
Συχνές ερωτήσεις
01Μπορώ να διαγράψω το αρχείο package-lock.json;
Συνιστάται να μην το κάνετε. Αυτό το αρχείο εξασφαλίζει ότι όλοι στην ομάδα και ο διακομιστής εγκαθιστούν τις ίδιες εκδόσεις· αν το διαγράψετε, στην επόμενη εγκατάσταση μπορεί να έρθουν διαφορετικές υπο-εκδόσεις.
02Ποια είναι η διαφορά ανάμεσα στο npm install και στο npm ci;
Το npm install ενημερώνει το αρχείο κλειδώματος όταν χρειάζεται και εγκαθιστά πάνω στον υπάρχοντα node_modules. Το npm ci χτίζει τον φάκελο από την αρχή και βγάζει σφάλμα αν το αρχείο κλειδώματος και το package.json δεν ταιριάζουν· για αυτό είναι πιο αξιόπιστο για ανάπτυξη σε παραγωγή.
03Γιατί δεν λειτουργεί η εντολή ενός πακέτου που εγκατέστησα καθολικά;
Ο καθολικός φάκελος πακέτων μπορεί να μην βρίσκεται στο PATH ή μπορεί να αλλάξατε έκδοση Node.js. Δείτε τον φάκελο με την εντολή npm prefix -g και προσθέστε τον στο PATH· αν χρησιμοποιείτε nvm, εγκαταστήστε ξανά το πακέτο στη νέα έκδοση.
Η εκμάθηση των εντολών npm ανοίγει την πόρτα στη σύγχρονη ανάπτυξη ιστού: εγκαθιστάτε με npm install, εκτελείτε με npm run και κάνετε ανάπτυξη με ασφάλεια με npm ci. Αν θέλετε να μετατρέψετε αυτή τη βάση σε ένα σύστημα φτιαγμένο για την επιχείρησή σας, δείτε τις λύσεις λογισμικού κατά παραγγελία της Aurora Yazılım ή επικοινωνήστε μαζί μας για το έργο σας.


