مشکلات ناسازگاری در ری اکت 19 React ، مشکل نصب وابستگی ها و عدم اجرا پس از نصب

مشکلات ناسازگاری در React معمولاً به دلیل تفاوت نسخه‌های کتابخانه‌ها یا وابستگی‌ها رخ می‌دهد. اگر بعد از نصب React نمی‌توانید برنامه را اجرا کنید، مراحل زیر را برای رفع مشکل دنبال کنید:

اگر مورد یک تا نه نتوانست برای شما مفید باشد یا اینکه میخواهید از اول و بدون دستکاری کدها یک پروژه ری اکتی را بدون ناسازگاری و بدون مشکل نصب و راه اندازی کنید: استفاده از نسخه 18 ری اکت به جای نصب React 19 (اگر از این نسخه استفاده می‌کنید). راهنمای این کار در توضیحات شماره 7 آمده است. در کانال تلگرامی عضو شوید و در ویرگول مرا دنبال کنید.

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



۱. بررسی نسخه‌های نصب‌شده

ابتدا مطمئن شوید که نسخه‌های React و React DOM با یکدیگر سازگار هستند. برای این کار:

  1. فایل package.json را باز کنید.
  2. بررسی کنید که نسخه‌های react و react-dom یکسان باشند. مثلاً:
&quotdependencies&quot: {
  &quotreact&quot: &quot^18.2.0&quot,
  &quotreact-dom&quot: &quot^18.2.0&quot
}

اگر نسخه‌ها متفاوت هستند، آن‌ها را به یک نسخه سازگار تغییر دهید.




۲. حذف node_modules و نصب مجدد وابستگی‌ها

گاهی اوقات مشکلات به دلیل خرابی فایل‌های نصب‌شده در node_modules رخ می‌دهد. برای رفع این مشکل:

  • پوشه node_modules و فایل package-lock.json (یا yarn.lock) را حذف کنید:
rm -rf node_modules package-lock.json

اگر از ویندوز استفاده می‌کنید، می‌توانید این پوشه و فایل را به صورت دستی حذف کنید.

  • وابستگی‌ها را دوباره نصب کنید:
npm install



۳. استفاده از --legacy-peer-deps

اگر مشکل به دلیل تعارض وابستگی‌ها است، می‌توانید از دستور زیر استفاده کنید:

npm install --legacy-peer-deps

این دستور به npm می‌گوید که تعارض‌های وابستگی را نادیده بگیرد.




۴. بررسی خطاهای ترمینال

اگر برنامه اجرا نمی‌شود، خطاهای ترمینال را با دقت بررسی کنید. این خطاها معمولاً اطلاعات مفیدی درباره مشکل ارائه می‌دهند. به دنبال عباراتی مانند Error, Failed, یا Cannot find module بگردید.



۵. بررسی فایل package.json

مطمئن شوید که فایل package.json شما صحیح است و اسکریپت‌های لازم برای اجرای پروژه وجود دارند. به عنوان مثال، باید اسکریپت‌های زیر وجود داشته باشند:

&quotscripts&quot: {
  &quotstart&quot: &quotreact-scripts start&quot,
  &quotbuild&quot: &quotreact-scripts build&quot,
  &quottest&quot: &quotreact-scripts test&quot,
  &quoteject&quot: &quotreact-scripts eject&quot
}



۶. اجرای پروژه

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

npm start

اگر همه چیز درست باشد، پروژه شما باید در مرورگر باز شود و در آدرس http://localhost:3000 قابل مشاهده باشد.



۷. استفاده از نسخه 18 ری اکت به جای نصب React 19 (اگر از این نسخه استفاده می‌کنید)

اگر از React 19 استفاده می‌کنید، ممکن است برخی کتابخانه‌ها (مانند @testing-library/react) هنوز با این نسخه سازگار نباشند. در این صورت:

  1. یا نسخه React را به 18 داون گرید کنید یا کاهش دهید:
npm install react@18 react-dom@18

2. یا منتظر به‌روزرسانی کتابخانه‌های شخص ثالث باشید.



۸. استفاده از yarn (اگر npm مشکل دارد)

اگر همچنان با npm مشکل دارید، می‌توانید از yarn استفاده کنید:

  1. yarn را نصب کنید (اگر نصب نیست):
npm install -g yarn

2. وابستگی‌ها را با yarn نصب کنید:

yarn install

3. پروژه را اجرا کنید:

yarn start



۹. ایجاد پروژه جدید (اگر مشکل حل نشد)

اگر هیچ‌کدام از روش‌های بالا کار نکرد، می‌توانید یک پروژه جدید ایجاد کنید و فایل‌های خود را به آن منتقل کنید:

  1. یک پروژه جدید ایجاد کنید:
npx create-react-app my-new-app

2. فایل‌های خود (مانند src/, public/ و غیره) را به پروژه جدید منتقل کنید.

3. وابستگی‌های اضافی را نصب کنید:

npm install <package-name>

4. پروژه را اجرا کنید:

npm start



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

https://vrgl.ir/zdkr1

در پست بالا میتوانید به سادگی بدون انتظار زیاد برای نصب ری‌اکت از راه اصلی ان، با سرعت بسیار بالاتری ری‌اکت را نصب کنید.