Οδηγοί εγκατάστασης

Ρύθμιση React με Vite

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

Aurora YazılımΣυντακτική ομάδα 6 λεπτά ανάγνωσης
Setting Up React with Vite
Πώς εγκαθίσταται το React με το Vite;

Για να στήσετε 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.

powershell
winget install OpenJS.NodeJS.LTS node -v npm -v

macOS

Μπορείτε να χρησιμοποιήσετε το επίσημο πρόγραμμα εγκατάστασης ή να εγκαταστήσετε με μία μόνο εντολή αν υπάρχει το Homebrew.

bash
brew install node node -v npm -v

Linux

Η έκδοση του Node στα αποθετήρια των διανομών είναι συχνά ξεπερασμένη. Η εγκατάσταση σε επίπεδο χρήστη με το nvm σας δίνει μια τρέχουσα έκδοση και καταργεί την ανάγκη για sudo· αφού εγκαταστήσετε το nvm με το script της δικής του σελίδας στο GitHub, εκτελέστε τις παρακάτω εντολές.

bash
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) λειτουργεί.
bashΔημιουργία και εκτέλεση του έργου
npm create vite@latest benim-uygulamam -- --template react-ts cd benim-uygulamam npm install npm run dev
bashΑν χρησιμοποιείτε pnpm ή yarn
pnpm 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.tsPlugins, aliases, ρυθμίσεις server και build
package.jsonΕξαρτήσεις και scripts dev, build και preview

Μεταβλητές περιβάλλοντος

Το Vite εκθέτει στον κώδικα πελάτη μόνο τις μεταβλητές που ξεκινούν με το πρόθεμα VITE_ και τις προσπελάζετε μέσω του import.meta.env. Αυτές οι μεταβλητές ενσωματώνονται στο πακέτο που στέλνεται στο πρόγραμμα περιήγησης· μην βάζετε εδώ ποτέ πράγματα όπως μυστικά κλειδιά API, κρατήστε τα στην πλευρά του διακομιστή.

bash.env.local
VITE_API_URL=https://api.ornek.com

Build και ανάπτυξη

Ο 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.
bash
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 παίρνει λίγα λεπτά· η πραγματική προσπάθεια βρίσκεται στην αρχιτεκτονική της εφαρμογής που χτίζετε πάνω της. Αν χρειάζεστε προσαρμοσμένο πίνακα, λογισμικό κρατήσεων ή διαχείρισης για την επιχείρησή σας, δείτε τις λύσεις λογισμικού ανά κλάδο· για έναν γρήγορο, πρωτότυπο ιστότοπο, ρίξτε μια ματιά στην υπηρεσία μας σχεδιασμός ιστοσελίδων.

Συνεχίστε την ανάγνωση

Σχετικά άρθρα

Όλες οι αναρτήσεις Οδηγών εγκατάστασης