ارشد نرمافزار و توسعهدهنده React و Next.js🚀 | طراحی سایتهای مدرن و کاربرپسند | ارتباط با من zil.ink/seyedahmaddev
مشکلات ناسازگاری در ری اکت 19 React ، مشکل نصب وابستگی ها و عدم اجرا پس از نصب
مشکلات ناسازگاری در React
معمولاً به دلیل تفاوت نسخههای کتابخانهها یا وابستگیها رخ میدهد. اگر بعد از نصب React
نمیتوانید برنامه را اجرا کنید، مراحل زیر را برای رفع مشکل دنبال کنید:
اگر مورد یک تا نه نتوانست برای شما مفید باشد یا اینکه میخواهید از اول و بدون دستکاری کدها یک پروژه ری اکتی را بدون ناسازگاری و بدون مشکل نصب و راه اندازی کنید: استفاده از نسخه 18 ری اکت به جای نصب React 19 (اگر از این نسخه استفاده میکنید). راهنمای این کار در توضیحات شماره 7 آمده است. در کانال تلگرامی عضو شوید و در ویرگول مرا دنبال کنید.
اگر هیچکدام از راه ها جواب نداد به انتهای پست مراجعه کنید تا راه حل دیگری برای نصب بدون مشکل به شما معرفی کنم.

۱. بررسی نسخههای نصبشده
ابتدا مطمئن شوید که نسخههای React
و React DOM
با یکدیگر سازگار هستند. برای این کار:
- فایل
package.json
را باز کنید. - بررسی کنید که نسخههای
react
وreact-dom
یکسان باشند. مثلاً:
"dependencies": {
"react": "^18.2.0",
"react-dom": "^18.2.0"
}
اگر نسخهها متفاوت هستند، آنها را به یک نسخه سازگار تغییر دهید.
۲. حذف 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
شما صحیح است و اسکریپتهای لازم برای اجرای پروژه وجود دارند. به عنوان مثال، باید اسکریپتهای زیر وجود داشته باشند:
"scripts": {
"start": "react-scripts start",
"build": "react-scripts build",
"test": "react-scripts test",
"eject": "react-scripts eject"
}
۶. اجرای پروژه
پس از رفع مشکلات، پروژه را با دستور زیر اجرا کنید:
npm start
اگر همه چیز درست باشد، پروژه شما باید در مرورگر باز شود و در آدرس http://localhost:3000
قابل مشاهده باشد.
۷. استفاده از نسخه 18 ری اکت به جای نصب React 19
(اگر از این نسخه استفاده میکنید)
اگر از React 19
استفاده میکنید، ممکن است برخی کتابخانهها (مانند @testing-library/react
) هنوز با این نسخه سازگار نباشند. در این صورت:
- یا نسخه
React
را به18
داون گرید کنید یا کاهش دهید:
npm install react@18 react-dom@18
2. یا منتظر بهروزرسانی کتابخانههای شخص ثالث باشید.
۸. استفاده از yarn
(اگر npm
مشکل دارد)
اگر همچنان با npm
مشکل دارید، میتوانید از yarn
استفاده کنید:
yarn
را نصب کنید (اگر نصب نیست):
npm install -g yarn
2. وابستگیها را با yarn
نصب کنید:
yarn install
3. پروژه را اجرا کنید:
yarn start
۹. ایجاد پروژه جدید (اگر مشکل حل نشد)
اگر هیچکدام از روشهای بالا کار نکرد، میتوانید یک پروژه جدید ایجاد کنید و فایلهای خود را به آن منتقل کنید:
- یک پروژه جدید ایجاد کنید:
npx create-react-app my-new-app
2. فایلهای خود (مانند src/
, public/
و غیره) را به پروژه جدید منتقل کنید.
3. وابستگیهای اضافی را نصب کنید:
npm install <package-name>
4. پروژه را اجرا کنید:
npm start
راه حل نهایی: اگر بالاخره نتوانستید از هیچ کدام از راه های بالا استفاده کنید به این پست مراجعه کنید.
https://vrgl.ir/zdkr1
در پست بالا میتوانید به سادگی بدون انتظار زیاد برای نصب ریاکت از راه اصلی ان، با سرعت بسیار بالاتری ریاکت را نصب کنید.
مطلبی دیگر از این انتشارات
HOC یا Higher Order Component در ری اکت
مطلبی دیگر از این انتشارات
سرور کامپوننت و SSR در React: یه راهنمای ساده
مطلبی دیگر از این انتشارات
آموزش ساخت تم در MUI برای اپلیکیشنهای ری اکت