نحوه نصب و راه‌اندازی ری‌اکت جی‌اس (react js)


اگه تازه می‌خوای وارد دنیای ری‌اکت جی‌اس بشی یا حتی برنامه‌نویس حرفه‌ای‌ای هستی که می‌خوای بدون دردسر محیط ری‌اکت جی‌اس رو راه بندازی، این آموزش کامل مخصوص توئه! از نصب Node.js تا ساخت اولین پروژه‌ی ری‌اکت جی‌اس رو باهم قدم‌به‌قدم پیش می‌بریم.

نحوه نصب و راه‌اندازی ری‌اکت جی‌اس (react js)

مقدمه: چرا ری‌اکت جی‌اس؟

ری‌اکت جی‌اس یک کتابخانه جاوااسکریپتی است که توسط فیسبوک توسعه یافته و به توسعه‌دهندگان اجازه می‌دهد رابط‌های کاربری پیچیده و تعاملی را به‌سادگی ایجاد کنند. یادگیری ری‌اکت جی‌اس پایه‌ای است برای هر توسعه‌دهنده فرانت‌اند حرفه‌ای.

مرحله ۱: نصب Node.js و NPM

برای اجرای ری‌اکت جی‌اس به Node.js و NPM نیاز دارید. ابتدا بررسی کنید که Node روی سیستم نصب شده باشد:

node -v

اگر نسخه Node نمایش داده شد، یعنی همه چیز آماده است. در غیر این صورت نسخه LTS را از سایت رسمی نصب کنید:

https://nodejs.org

مرحله ۲: ساخت اولین پروژه ری‌اکت جی‌اس

برای شروع دو روش اصلی وجود دارد:

روش ۱: Create React App

در پوشه موردنظر دستور زیر را اجرا کنید:

npx create-react-app my-app

سپس وارد فولدر پروژه شوید و آن را اجرا کنید:

cd my-app
npm start

اگر مرورگر باز شد و صفحه React ظاهر شد، پروژه با موفقیت اجرا شده است.

روش ۲: Vite

برای پروژه‌های حرفه‌ای و با سرعت بالا، Vite گزینه مناسب‌تری است:

npm create vite@latest my-app

فریم‌ورک React را انتخاب کنید، سپس:

cd my-app
npm install
npm run dev

مرحله ۳: آشنایی با ساختار پروژه

پس از ایجاد پروژه، چند پوشه و فایل کلیدی خواهید داشت:

  • src/ → محل نوشتن کد اصلی
  • public/ → فایل‌های ثابت مانند index.html و تصاویر
  • package.json → مدیریت پکیج‌ها و اسکریپت‌ها
  • node_modules/ → پوشه پکیج‌های نصب شده

فایل مهم برای شروع: src/App.js

مرحله ۴: تست اولین تغییر

برای اطمینان از عملکرد پروژه، یک تغییر ساده انجام دهید:


function Welcome() {
  return <h1>Hello,World</h1>;
}
export default Welcome;

پس از ذخیره، مرورگر به‌طور خودکار تغییرات را نمایش می‌دهد.

مرحله ۵: مشکلات رایج

  • Command not found: npx → Node.js را بررسی یا مجدداً نصب کنید
  • npm ERR! code EACCES → مجوزهای سیستم عامل را بررسی کنید
  • Port 3000 already in use → از پورت دیگری استفاده کنید:
    npm start -- --port=3001

نکات حرفه‌ای

  • استفاده از VS Code و افزونه‌های مخصوص ری‌اکت
  • نصب ESLint و Prettier برای کدنویسی تمیز
  • آشنایی با Hooks مانند useState و useEffect
  • مدیریت ورژن پروژه با Git

جمع‌بندی

اکنون شما می‌دانید چگونه ری‌اکت جی‌اس را نصب و اجرا کنید، پروژه را راه‌اندازی کنید و مشکلات رایج را رفع نمایید. قدم بعدی می‌تواند یادگیری پیشرفته‌تر مفاهیم ری‌اکت مانند کامپوننت‌ها، مدیریت State و استفاده از React Router باشد.

تگ‌ها: