Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Διαχειριστείτε project με npm: init και ανατομία package.json, scripts, dependencies εναντίον devDependencies και το ci έναντίον install.
Το hello.mjs ήταν ένα αρχείο. Τα πραγματικά projects είναι πακέτα: έχουν όνομα, έκδοση, εντολές (scripts) και βιβλιοθήκες (dependencies). Όλα αυτά ορίζονται σε ένα αρχείο, το package.json, και τα διαχειρίζεστε με το npm (έρχεται μαζί με το Node.js).
# Μέσα στον φάκελο του project: σκελετός με προεπιλογές (όνομα = όνομα φακέλου)
npm init -y{
"name": "roboschool-lab",
"version": "1.0.0",
"type": "module",
"scripts": {
"test": "node --test"
}
}Τρία πεδία αρκούν για αρχή: name (πεζά, λατινικά, με παύλες), version (μορφή major.minor.patch) και scripts (οι εντολές σας). Το "type": "module" λέει στο Node να διαβάζει import/ES modules. Δείτε το package.json reference για όλα τα πεδία.
Τα scripts είναι ψευδώνυμα εντολών — η «κονσόλα» του project:
{
"scripts": {
"dev": "node server.mjs",
"test": "node --test",
"check": "npx tsc --noEmit"
}
}# Εκτέλεση script με το όνομά του
npm run test
npm run checkΑντί να θυμάστε (και να πληκτρολογείτε) μακριές εντολές, τις βάζετε μία φορά στο package.json και τις τρέχετε με npm run <όνομα>. Το npx εκτελεί εργαλείο χωρίς εγκατάσταση (εδώ τον TypeScript compiler). Συμβουλή: το start και το test τρέχουν και χωρίς run (npm test).
# Βιβλιοθήκη που χρειάζεται η ΕΦΑΡΜΟΓΗ για να τρέξει (π.χ. σε παραγωγή)
npm install zod
# Εργαλείο που χρειάζεστε ΜΟΝΟ για ανάπτυξη (tests, types, lint)
npm install -D vitestdependencies (-S, η προεπιλογή): κώδικας που τρέχει μαζί με την εφαρμογή — validation, router, database client. Εγκαθίστανται παντού, και στην παραγωγή.devDependencies (-D): εργαλεία — test runners, type checkers, linters. Στην παραγωγή παραλείπονται (npm ci --omit=dev).Λάθος κατηγορία = λάθος κόστος: test framework στις dependencies φουσκώνει το production install· βιβλιοθήκη runtime στις devDependencies σπάει την παραγωγή που την παραλείπει.
# Ανάπτυξη: εγκαθιστά + ΕΝΗΜΕΡΩΝΕΙ το lockfile αν χρειαστεί
npm install
# CI / παραγωγή: αναπαράγει ΑΚΡΙΒΩΣ το lockfile, αποτυγχάνει αν δεν ταιριάζει
npm ciΤο package.json λέει «θέλω vitest έκδοσης ^5.0.5» (εύρος)· το package-lock.json κλειδώνει «ακριβώς την 5.0.5, με αυτά τα hashes». Κανόνες:
npm ci: ίδιο lockfile = ίδιες εκδόσεις = αναπαραγώγιμο build. (Δείτε το npm-ci και το npm-install.)node_modules (όπου κατεβαίνουν τα πακέτα) δεν μπαίνει στο Git — προσθέστε τον στο .gitignore.Συνέχεια στη διαδρομή: τα objects, arrays & modules εξηγούν το
importπου διαβάζει αυτά τα πακέτα, το CI workflow δείχνει τοnpm ciσε δράση, και ο οδηγός Τερματικό από το Μηδέν καλύπτει το τερματικό αν κολλήσετε.
npm init -y φτιάχνει σκελετό package.json με name/version/scripts.npm run test)· το npx τρέχει εργαλεία χωρίς εγκατάσταση.dependencies, εργαλεία στις devDependencies (-D).npm install, στο CI πάντα npm ci· ποτέ χειροκίνητη επεξεργασία του lockfile· node_modules στο .gitignore.