هل سبق لك أن كتبت الأمر `java -version` في موجه الأوامر لتواجه خطأ " مسار جافا غير معروف " المُحبط؟ 😩 لست وحدك! هذه المشكلة الشائعة تُعيق المطورين والطلاب ومحبي جافا حول العالم. لكن لا تقلق، فحلّها بسيط بمجرد معرفة الخطوات. في هذا الدليل المُختصر، سنُبسط المشكلة ونجعل بيئة جافا تعمل بسلاسة. بنهاية الدليل، ستتمكن من تجميع التعليمات البرمجية كالمحترفين. هيا بنا نبدأ!
ماذا يعني "لم يتم التعرف على مسار جافا"؟
يظهر خطأ " مسار جافا غير معروف " (ويُصاغ غالبًا على أنه "لم يتم التعرف على 'java' كأمر داخلي أو خارجي") عندما يتعذر على موجه الأوامر في نظامك تحديد موقع ملف جافا التنفيذي. يحدث هذا لأن دليل تثبيت جافا غير مُضاف إلى متغير بيئة PATH في نظامك. وبدون ذلك، لا يعرف نظام ويندوز مكان العثور على java.exe أو javac.exe .
لماذا يُعدّ هذا الأمر مهمًا؟ تُعتبر لغة جافا ضرورية لتشغيل التطبيقات، وبناء مشاريع أندرويد، وحتى البرامج النصية البسيطة. يضمن إصلاح مسار جافا إمكانية تنفيذ أوامر مثل `java -version` أو `javac HelloWorld.java` من أي مكان في موجه الأوامر. هل أنت مستعد لحل المشكلة؟ سنشرح عملية التحقق والتثبيت وإعداد مسار جافا لأحدث إصدار من JDK (حتى عام 2026).
الخطوة الأولى: التحقق من تثبيت جافا بشكل صحيح
قبل تعديل المسارات، تأكد من تثبيت Java على نظامك. افتح موجه الأوامر (اضغط على مفتاحي Win + R، واكتب cmd ، ثم اضغط على Enter) وقم بتشغيل الأمر التالي:
- java -version – يتحقق من بيئة تشغيل جافا (JRE).
- javac -version – يتحقق من إصدار مترجم جافا (JDK).
إذا أظهر كلا البرنامجين معلومات الإصدار (مثلاً، "إصدار جافا 21.0.1" لأحدث إصدار LTS)، فأنت جاهز - انتقل إلى الخطوة 3. وإذا لم يُظهرا ذلك، فتابع عملية التثبيت. نصيحة احترافية: استخدم Oracle JDK أو OpenJDK الرسميين لضمان الموثوقية.
الخطوة الثانية: قم بتنزيل وتثبيت أحدث إصدار من Java JDK
إذا لم يكن برنامج Java مثبتًا أو كان إصداره قديمًا، فقم بتنزيل أحدث إصدار. اعتبارًا من عام 2026، يُنصح باستخدام Oracle JDK 21 (LTS) أو إصدارات OpenJDK لضمان الاستقرار والأمان.
- قم بزيارة صفحة تنزيلات Oracle Java الرسمية أو Eclipse Adoptium لـ OpenJDK.
- قم بتنزيل برنامج تثبيت Windows x64 (.exe) المناسب لبنية نظامك.
- قم بتشغيل برنامج التثبيت كمسؤول. اتبع التعليمات - الخيارات الافتراضية تعمل بشكل جيد. لاحظ مسار التثبيت (عادةً C:\Program Files\Java\jdk-21 ).
- أعد تشغيل جهاز الكمبيوتر الخاص بك للتأكد من تطبيق التغييرات.
بعد التثبيت، أعد تشغيل عمليات التحقق من الإصدار من الخطوة 1. هل ما زلت ترى رسالة " لم يتم التعرف على مسار جافا "؟ حان الوقت لضبط متغير PATH.
الخطوة 3: كيفية ضبط مسار جافا في متغيرات بيئة ويندوز
يكمن حل مشكلة عدم التعرف على مسار جافا في موجه الأوامر في تحديث متغير PATH. يُخبر هذا المتغير نظام ويندوز بمكان البحث عن ملفات جافا التنفيذية. سنقوم بذلك عبر خصائص النظام - لا حاجة لأي برمجة! 👏
ملاحظة: تنطبق هذه الخطوات على نظامي التشغيل ويندوز 10/11. أما بالنسبة للإصدارات الأقدم، فإن الواجهة متشابهة.
- انقر بزر الماوس الأيمن على "هذا الكمبيوتر" (أو "جهاز الكمبيوتر الخاص بي") على سطح المكتب أو في مستكشف الملفات، ثم حدد خصائص .
- انقر على إعدادات النظام المتقدمة على اليسار.
- في نافذة خصائص النظام، انقر فوق متغيرات البيئة .
- ضمن "متغيرات النظام" (القسم السفلي)، قم بالتمرير للعثور على المسار وانقر فوق تحرير .
- انقر فوق "جديد" وأضف هذين المدخلين (استبدلهما بمسار التثبيت الخاص بك إذا كان مختلفًا):
- C:\Program Files\Java\jdk-21\bin (لـ JDK)
- C:\Program Files\Java\jre-21\bin (لـ JRE، إذا تم تثبيته بشكل منفصل)
- انقر فوق "موافق" في جميع النوافذ لحفظ التغييرات.
- أغلق موجه الأوامر وأعد فتحه (مهم - الجلسات القديمة لن ترى التغييرات).
اختبره: شغّل الأمرَين `java -version` و` javac -version` . هل نجحت العملية؟ 🎉 لقد تم حل مشكلة مسار Java ! إذا لم تنجح، فتأكد من صحة المسار تمامًا - يجب أن يكون مسار مجلد bin الخاص بـ Java مطابقًا للمسار الأصلي.
الأخطاء الشائعة والحلول السريعة
حتى مع اتباع الخطوات الصحيحة، قد تحدث بعض المشاكل. إليك جدول مفيد يتضمن المشاكل الشائعة وحلولها لمساعدتك على البقاء على المسار الصحيح:
| مشكلة |
الأعراض |
يصلح |
| إصدارات متعددة من جافا |
تظهر نسخة خاطئة |
قم بإزالة الإصدارات القديمة من خلال لوحة التحكم > البرامج. أعطِ الأولوية لأحدث إصدار في مسار النظام (ضعه في المقدمة). |
| المسار طويل جدًا |
لا يمكن إضافة إدخالات |
قم بتنظيف المسارات غير الضرورية أو استخدم موجه الأوامر: setx PATH "%PATH%;C:\Program Files\Java\jdk-21\bin" /M (قم بتشغيله كمسؤول). |
| صلاحيات المسؤول مفقودة |
التغييرات لا تدوم |
قم بتشغيل خصائص النظام كمسؤول (انقر بزر الماوس الأيمن > تشغيل كمسؤول). |
| عدم التوافق بين 32 بت و 64 بت |
تفشل الأوامر بشكل عشوائي |
تأكد من أن إصدار JDK الخاص بك متوافق مع نظام التشغيل لديك (معظم الأنظمة تستخدم 64 بت). أعد التثبيت إذا لزم الأمر. |
نصيحة إضافية: إذا كنت تستخدم جهازًا تابعًا للشركة، فقد تمنع سياسات تكنولوجيا المعلومات إجراء التغييرات - اسأل مسؤول النظام أو استخدم إصدارًا محمولًا من جافا.
متقدم: ضبط متغير JAVA_HOME
بالنسبة للإعدادات الاحترافية (مثل بيئات التطوير المتكاملة مثل IntelliJ أو Maven)، قم أيضًا بتعيين متغير البيئة JAVA_HOME . في متغيرات البيئة:
- ضمن متغيرات النظام، انقر فوق جديد .
- اسم المتغير: JAVA_HOME
- قيمة المتغير: C:\Program Files\Java\jdk-21 (الجذر فقط، بدون \bin).
- قم بتعديل PATH ليشمل %JAVA_HOME%\bin بدلاً من المسار الكامل لمزيد من المرونة.
هذا يجعل إعداد Java لديك ديناميكيًا - إذا قمت بتحديث الإصدارات، فما عليك سوى تغيير JAVA_HOME. اختبر ذلك باستخدام الأمر echo %JAVA_HOME% في موجه الأوامر (CMD).
أهمية هذا الإصلاح والخطوات التالية
إن حل مشكلة " مسار جافا غير مُعترف به في موجه الأوامر " لا يقتصر على إنهاء الإحباط فحسب، بل يتعلق بإطلاق العنان للإمكانيات الكاملة لجافا. سواء كنتَ تُبرمج برنامج "Hello World" لأول مرة أو تُنشئ تطبيقات مؤسسية، فإن مسارًا صحيحًا يضمن الكفاءة. والآن بعد حل المشكلة، لمَ لا تُجرب تجميع برنامج بسيط؟
احفظ هذا الملف باسم HelloWorld.java:
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Java PATH fixed! 🚀");
}
}
شغّل الأمر javac HelloWorld.java ثم الأمر java HelloWorld . هل نجح الأمر؟ أحسنت! 👏
إذا استمرت المشاكل، فراجع وثائق جافا الرسمية أو منتديات مثل ستاك أوفرفلو. بالنسبة لمستخدمي ماك/لينكس، تختلف العملية (استخدم الأمر export PATH في سطر الأوامر) - أخبرنا في التعليقات إذا كنت بحاجة إلى دليل!
تابعونا للمزيد من النصائح حول تطوير تطبيقات جافا. برمجة ممتعة! 🌟