Ρύθμιση React με Vite
Δείχνουμε πώς να δημιουργήσετε ένα έργο React και TypeScript με το Vite, να εκτελέσετε τον dev server, να κάνετε build και ανάπτυξη και να διορθώσετε συνηθισμένα σφάλματα.

Για να στήσετε React με το Vite, εγκαταστήστε πρώτα την τρέχουσα έκδοση LTS του Node.js. Έπειτα εκτελέστε στο τερματικό npm create vite@latest, γράψτε ένα όνομα έργου και επιλέξτε το πρότυπο React και TypeScript. Μπείτε στον φάκελο του έργου, εγκαταστήστε τις εξαρτήσεις με npm install και ξεκινήστε τον dev server με npm run dev· ο ιστότοπος ανοίγει από προεπιλογή στο localhost:5173.
Τι είναι το Vite και γιατί να το χρησιμοποιήσετε;
Το Vite είναι ένα εργαλείο build και dev server φτιαγμένο για σύγχρονα έργα ιστού. Κατά την ανάπτυξη σερβίρει τον κώδικα χρησιμοποιώντας την εγγενή υποστήριξη ES modules του προγράμματος περιήγησης και επεξεργάζεται μόνο το αρχείο που ζητείται. Γι αυτό ο διακομιστής ξεκινά μέσα σε δευτερόλεπτα ακόμη και καθώς το έργο μεγαλώνει, και μια αλλαγή που αποθηκεύετε εμφανίζεται στην οθόνη χωρίς επαναφόρτωση της σελίδας.
Για την παραγωγή, το Vite πακετάρει τον κώδικά σας σε συμπιεσμένα, χωρισμένα αρχεία με ονόματα φιλικά προς την cache. Προσφέρει έτοιμα πρότυπα για βιβλιοθήκες όπως React, Vue και Svelte και έχει γίνει ένα από τα πιο συνηθισμένα σημεία εκκίνησης στο οικοσύστημα του React.
Το Vite ως εναλλακτική του Create React App
Για πολλά χρόνια τα έργα React ξεκινούσαν με το Create React App. Η ομάδα του React δεν προτείνει πλέον αυτό το εργαλείο για νέα έργα· η επίσημη τεκμηρίωση προτείνει να ξεκινήσετε είτε με ένα framework (όπως το Next.js) είτε με ένα εργαλείο build όπως το Vite. Αν αναζητάτε μια εναλλακτική του Create React App, το Vite είναι ο ταχύτερος δρόμος μετάβασης με τις λιγότερες ρυθμίσεις.
Αν χρειάζεστε απόδοση σελίδων στον διακομιστή, δρομολόγηση βάσει αρχείων και έτοιμη έξοδο σελίδων για SEO, δείτε τον οδηγό μας Εγκατάσταση Next.js. Για πίνακα διαχείρισης, εσωτερικό εργαλείο ή εφαρμογή μίας σελίδας (SPA), το Vite είναι συνήθως η απλούστερη επιλογή.
Προαπαιτούμενα
Η μόνη πραγματική προϋπόθεση για το Vite είναι το Node.js. Οι νέες εκδόσεις του Vite σταματούν να υποστηρίζουν παλαιότερες εκδόσεις του Node, γι αυτό η εγκατάσταση της τρέχουσας έκδοσης LTS από το nodejs.org είναι ο ασφαλέστερος δρόμος. Το npm συνοδεύει το Node.js.
- Η τρέχουσα έκδοση LTS του Node.js και το npm που την συνοδεύει.
- Ένας επεξεργαστής κώδικα· για την εγκατάσταση και τις προτεινόμενες επεκτάσεις, δείτε το άρθρο μας Εγκατάσταση VS Code.
- Τερματικό: PowerShell ή Windows Terminal στα Windows, Terminal στο macOS και το κέλυφος της επιλογής σας στο Linux.
- Προαιρετικά: Git για έλεγχο εκδόσεων.
Node.js ανά λειτουργικό σύστημα
Μπορείτε να κατεβάσετε και να εγκαταστήσετε το Node.js από το nodejs.org. Αν θα χρησιμοποιείτε διαφορετικές εκδόσεις του Node σε πολλά έργα, η επιλογή ενός διαχειριστή εκδόσεων σάς διευκολύνει αργότερα.
Windows
Κατεβάστε το πρόγραμμα εγκατάστασης LTS από το nodejs.org και εγκαταστήστε το με τις προεπιλεγμένες επιλογές ή χρησιμοποιήστε το winget στο PowerShell. Μετά την εγκατάσταση, κλείστε και ανοίξτε ξανά το τερματικό ώστε να ενημερωθεί το PATH.
winget install OpenJS.NodeJS.LTS node -v npm -vmacOS
Μπορείτε να χρησιμοποιήσετε το επίσημο πρόγραμμα εγκατάστασης ή να εγκαταστήσετε με μία μόνο εντολή αν υπάρχει το Homebrew.
brew install node node -v npm -vLinux
Η έκδοση του Node στα αποθετήρια των διανομών είναι συχνά ξεπερασμένη. Η εγκατάσταση σε επίπεδο χρήστη με το nvm σας δίνει μια τρέχουσα έκδοση και καταργεί την ανάγκη για sudo· αφού εγκαταστήσετε το nvm με το script της δικής του σελίδας στο GitHub, εκτελέστε τις παρακάτω εντολές.
nvm install --lts nvm use --lts node -vΒήματα δημιουργίας ενός έργου React
Μόλις είναι έτοιμο το Node.js, η δημιουργία ενός έργου React είναι ίδια σε κάθε λειτουργικό σύστημα. Η εντολή σας καθοδηγεί διαδραστικά: ζητά το όνομα του έργου, το framework (React) και την παραλλαγή (TypeScript). Αν θέλετε να ορίσετε το πρότυπο απευθείας στην εντολή, χρησιμοποιήστε τη μορφή παρακάτω· στο npm, οι επιπλέον παράμετροι μπαίνουν μετά τη διπλή παύλα.
- Αν θέλετε να δουλέψετε με JavaScript, το όνομα του προτύπου είναι react· για TypeScript είναι react-ts.
- Ανοίξτε στο πρόγραμμα περιήγησής σας τη διεύθυνση που εμφανίζεται στη γραμμή Local του τερματικού (από προεπιλογή localhost:5173).
- Αλλάξτε κάποιο κείμενο στο src/App.tsx και αποθηκεύστε· αν η σελίδα ενημερώνεται χωρίς επαναφόρτωση, το HMR (hot module replacement) λειτουργεί.
npm create vite@latest benim-uygulamam -- --template react-ts cd benim-uygulamam npm install npm run devpnpm create vite benim-uygulamam --template react-ts yarn create vite benim-uygulamam --template react-tsΓνωρίστε τη δομή του έργου
Το πρώτο που προσέχετε σε ένα έργο Vite είναι ότι το index.html βρίσκεται στον ριζικό κατάλογο. Το Vite χρησιμοποιεί αυτό το αρχείο ως σημείο εισόδου και η ετικέτα script μέσα σε αυτό καλεί το src/main.tsx.
| Αρχείο / φάκελος | Σκοπός |
|---|---|
| index.html | Η σελίδα εισόδου της εφαρμογής· εδώ βρίσκονται ο τίτλος και οι ετικέτες meta |
| src/main.tsx | Το αρχείο εκκίνησης που φορτώνει το React στη σελίδα |
| src/App.tsx | Το κύριο component· χτίστε από εδώ τις δικές σας σελίδες |
| public/ | Αρχεία που αντιγράφονται ως έχουν, χωρίς επεξεργασία: favicon, robots.txt |
| vite.config.ts | Plugins, aliases, ρυθμίσεις server και build |
| package.json | Εξαρτήσεις και scripts dev, build και preview |
Μεταβλητές περιβάλλοντος
Το Vite εκθέτει στον κώδικα πελάτη μόνο τις μεταβλητές που ξεκινούν με το πρόθεμα VITE_ και τις προσπελάζετε μέσω του import.meta.env. Αυτές οι μεταβλητές ενσωματώνονται στο πακέτο που στέλνεται στο πρόγραμμα περιήγησης· μην βάζετε εδώ ποτέ πράγματα όπως μυστικά κλειδιά API, κρατήστε τα στην πλευρά του διακομιστή.
VITE_API_URL=https://api.ornek.comBuild και ανάπτυξη
Ο dev server προορίζεται μόνο για τοπική εργασία. Την έκδοση που θα αναπτύξετε την παράγετε με npm run build· η έξοδος γράφεται στον φάκελο dist. Το npm run preview σας επιτρέπει να δοκιμάσετε αυτήν την έξοδο τοπικά με τρόπο κοντά στην πραγματική παραγωγή.
Ο φάκελος dist αποτελείται από απλά αρχεία HTML, CSS και JavaScript· μπορεί να ανέβει σε οποιαδήποτε στατική φιλοξενία ή σε web server όπως το Nginx. Για την ταχύτητα, είναι σημαντικό τα αρχεία να είναι συμπιεσμένα και να σερβίρονται με επικεφαλίδες cache μακράς διάρκειας· αυτές τις ρυθμίσεις τις εξηγούμε αναλυτικά στη σελίδα μας διαχείριση ταχύτητας και απόδοσης.
- Αν η εφαρμογή θα δημοσιευτεί σε υποφάκελο (example.com/panel/), ορίστε την επιλογή base στο vite.config.ts σε αυτήν τη διαδρομή.
- Αν χρησιμοποιείτε React Router, προσθέστε έναν κανόνα στον διακομιστή που ανακατευθύνει όλες τις άγνωστες διευθύνσεις στο index.html.
- Για σελίδες περιεχομένου που πρέπει να εμφανίζονται στις μηχανές αναζήτησης, η απόδοση μόνο στην πλευρά του πελάτη μπορεί να μην αρκεί· εδώ αποκτά σημασία μια προσέγγιση σχεδιασμού ιστοσελίδων φιλικού προς το SEO.
npm run build npm run previewΣυνηθισμένα σφάλματα και λύσεις
Τα περισσότερα σφάλματα σε μια εγκατάσταση Vite προέρχονται από την έκδοση του Node, τη θύρα ή τις ρυθμίσεις ανάπτυξης. Ο παρακάτω πίνακας συνοψίζει τις πιο συνηθισμένες περιπτώσεις· για περισσότερες εντολές, δείτε τον οδηγό μας εντολές npm.
| Σύμπτωμα | Γιατί | Λύση |
|---|---|---|
| “Vite requires Node.js version...” warning | Παλιά έκδοση Node | Αλλάξτε στην τρέχουσα έκδοση LTS |
| Η θύρα 5173 χρησιμοποιείται | Η θύρα είναι ανοιχτή σε άλλη διεργασία | Το Vite δοκιμάζει την επόμενη θύρα· ορίστε το server.port για σταθερή θύρα |
| Η εντολή node δεν βρέθηκε | Το PATH δεν ενημερώθηκε | Κλείστε και ανοίξτε ξανά το τερματικό, επανεκκινήστε τον υπολογιστή αν χρειαστεί |
| Κενή λευκή σελίδα στην παραγωγή | Λάθος διαδρομή base | Διορθώστε τη ρύθμιση base ώστε να ταιριάζει με τον φάκελο ανάπτυξης |
| 404 κατά την ανανέωση της σελίδας | Δεν υπάρχει δρομολόγηση SPA στον διακομιστή | Ανακατευθύνετε όλες τις διαδρομές στο index.html |
Επόμενα βήματα
Όταν έχετε ένα έργο που λειτουργεί, μπορείτε να προσθέσετε εργαλεία όπως το React Router για δρομολόγηση, το TanStack Query για λήψη δεδομένων και το Tailwind CSS ή τα CSS Modules για στυλ. Για την ποιότητα του κώδικα, επεκτείνετε τις ρυθμίσεις ESLint που έρχονται με το πρότυπο ώστε να ταιριάζουν στο έργο σας.
Το Vite και το React μαζί αποτελούν ισχυρή βάση για επιχειρηματικές εφαρμογές, όπως πίνακας κρατήσεων, οθόνη αποθέματος, παρακολούθηση ραντεβού ή διαχείριση μενού με κωδικό QR. Σε προϊόντα σαν αυτά, το μοντέλο δεδομένων, η εξουσιοδότηση και τα αντίγραφα ασφαλείας έχουν την ίδια σημασία με τη διεπαφή· αν προτιμάτε να χτίσετε πάνω σε έτοιμη βάση, οι εξειδικευμένες λύσεις λογισμικού ανά κλάδο μπορούν να εξοικονομήσουν χρόνο.
Ο σχεδιασμός της διεπαφής έχει την ίδια σημασία με την τεχνική βάση: ο σχεδιασμός της ροής χρήστη και της διάταξης οθόνης πριν γράψετε components είναι η βάση της διαδικασίας σχεδιασμού UI/UX. Το να σκέφτεστε από την αρχή τα breakpoints για κινητά κοστίζει επίσης πολύ λιγότερο από το να τα διορθώνετε αργότερα για σχεδιασμό φιλικό προς κινητά.
Συχνές ερωτήσεις
01Είναι υποχρεωτικό το TypeScript σε ένα έργο Vite React;
Όχι, το πρότυπο react λειτουργεί με απλή JavaScript. Σε μεσαία και μεγάλα έργα όμως το TypeScript εντοπίζει σφάλματα καθώς γράφετε και διευκολύνει τη συνεργασία. Η μετάβαση αργότερα είναι δυνατή, αλλά αν ξεκινήσετε εξαρχής με react-ts θα έχετε λιγότερη δουλειά.
02Μπορώ να μεταφέρω το υπάρχον έργο μου Create React App στο Vite;
Ναι. Τα βασικά βήματα είναι η μετακίνηση του index.html στον ριζικό κατάλογο, η εγκατάσταση του Vite και του plugin React αντί για react-scripts και η αλλαγή των μεταβλητών με πρόθεμα REACT_APP_ σε πρόθεμα VITE_. Για μεγάλα έργα, δοκιμάστε το πρώτα σε ξεχωριστό branch και εκτελέστε τα τεστ.
03Είναι ένας ιστότοπος φτιαγμένος με Vite αρκετά καλός για SEO;
Για πίνακες ελέγχου και οθόνες εφαρμογών είναι εντάξει. Για σελίδες περιεχομένου που πρέπει να κατατάσσονται στις μηχανές αναζήτησης, είναι πιο υγιές το περιεχόμενο να παράγεται ως HTML στον διακομιστή· για αυτό προτιμάται ένα framework όπως το Next.js ή μια λύση pre-rendering.
04Να χρησιμοποιήσω pnpm αντί για npm;
Το pnpm χρησιμοποιεί αποδοτικότερα τον χώρο δίσκου και επιταχύνει τις εγκαταστάσεις· το Vite λειτουργεί μια χαρά με οποιονδήποτε διαχειριστή πακέτων. Έχει μεγαλύτερη σημασία να χρησιμοποιούν όλοι στην ομάδα το ίδιο εργαλείο παρά το ποιο θα επιλέξετε.
Η εγκατάσταση του React με το Vite παίρνει λίγα λεπτά· η πραγματική προσπάθεια βρίσκεται στην αρχιτεκτονική της εφαρμογής που χτίζετε πάνω της. Αν χρειάζεστε προσαρμοσμένο πίνακα, λογισμικό κρατήσεων ή διαχείρισης για την επιχείρησή σας, δείτε τις λύσεις λογισμικού ανά κλάδο· για έναν γρήγορο, πρωτότυπο ιστότοπο, ρίξτε μια ματιά στην υπηρεσία μας σχεδιασμός ιστοσελίδων.


