بدء استخدام Python في Excel

ينطبق على
Excel لـ Microsoft 365 Excel لـ Microsoft 365 لـ Mac

للحصول على معلومات التوفر، راجع توفر Python في Excel. إذا واجهت أي مخاوف بشأن Python في Excel، فالرجاء الإبلاغ عنها عن طريق تحديد ملاحظات التعليمات> في Excel.

هل أنت مستخدم جديد لميزة Python في Excel؟ ابدأ بمقدمة إلى Python في Excel.

بدء استخدام Python

لبدء استخدام Python في Excel، حدد خلية ومن علامة التبويب الصيغ ، حدد إدراج Python. يخبر هذا Excel أنك تريد كتابة صيغة Python في الخلية المحددة.

انتقل إلى الصيغ ثم حدد إدراج Python.

أو استخدم الدالة =PY في خلية لتمكين Python. بعد إدخال =PY في الخلية، اختر PY من قائمة الإكمال التلقائي للدالة باستخدام مفتاح Tab والسهم لأسفل، أو أضف قوس فتح إلى الدالة: =PY(. الآن، يمكنك إدخال تعليمة Python البرمجية مباشرة في الخلية. تظهر لقطة الشاشة التالية قائمة "إكمال تلقائي" مع تحديد الدالة PY.

أدخل =PY في خلية لتمكين Python.

بمجرد تمكين Python في خلية، تعرض هذه الخلية أيقونة LY . يعرض شريط الصيغة أيقونة PY نفسها عند تحديد خلية Python. راجع لقطة الشاشة التالية للحصول على مثال.

مصنف Excel مع تمكين Python في Excel في خلية، ويعرض أيقونة PY الخضراء في الخلية.

دمج Python مع خلايا ونطاقات Excel

للإشارة إلى كائنات Excel في خلية Python، تأكد من أن خلية Python في وضع التحرير، ثم حدد الخلية أو النطاق الذي تريد تضمينه في صيغة Python. يؤدي ذلك تلقائيا إلى تعبئة خلية Python بعنوان الخلية أو النطاق الذي حددته.

تلميح

استخدم اختصار لوحة المفاتيح F2 للتبديل بين وضع Enter ووضع التحرير في خلايا Python. يسمح لك التبديل إلى وضع التحرير بتحرير صيغة Python، كما يسمح لك التبديل إلى وضع Enter بتحديد خلايا أو نطاقات إضافية باستخدام لوحة المفاتيح. للتعرف على المزيد من اختصارات لوحة المفاتيح، راجع اختصارات لوحة المفاتيح Python في Excel.

تستخدم Python في Excel دالة xl() Python المخصصة للربط بين Excel وPython. تقبل الدالة xl() كائنات Excel مثل النطاقات والجداول والاستعلامات والأسماء.

يمكنك أيضا كتابة المراجع مباشرة في خلية Python باستخدام الدالة xl() . على سبيل المثال، للإشارة إلى الخلية A1، استخدم xl("A1") وللنطاق B1:C4xl("B1:C4"). لجدول يحتوي على رؤوس باسم "جدولي"، استخدم xl("MyTable[#All]", headers=True). يضمن المحدد [#All] تحليل الجدول بأكمله في صيغة Python، ويضمن headers=True معالجة رؤوس الجدول بشكل صحيح. لمعرفة المزيد حول المحددات مثل [#All]، راجع "استخدام المراجع المصنفة" في جداول Excel.

تظهر الصورة التالية عملية Python في Excel حسابية تضيف قيم الخليتين A1وB1، مع إرجاع نتيجة Python في الخلية C1.

استخدم دالة Python المخصصة xl() للربط بين Excel وPython.

شريط الصيغة

استخدم شريط الصيغة لسلوك التحرير الذي يشبه التعليمات البرمجية، مثل استخدام مفتاح الإدخال Enter لإنشاء أسطر جديدة. قم بتوسيع شريط الصيغة باستخدام أيقونة السهم لأسفل لعرض أسطر متعددة من التعليمات البرمجية في الوقت نفسه. يمكنك أيضا استخدام اختصار لوحة المفاتيح Ctrl+Shift+U لتوسيع شريط الصيغة. تعرض لقطات الشاشة التالية شريط صيغة قبل توسيعه وبعد توسيعه لعرض أسطر متعددة من تعليمة Python البرمجية.

قبل توسيع شريط الصيغة:
...

بعد توسيع شريط الصيغة:

قم بتوسيع شريط الصيغة لعرض المزيد من أسطر التعليمات البرمجية.

تلميح

للحصول على مساحة تحرير تعليمات برمجية أكبر وميزات مثل تلوين النص و IntelliSense، استخدم محرر التعليمات البرمجية Python في Excel.

أنواع المخرجات

استخدم قائمة إخراج Python في شريط الصيغة للتحكم في كيفية إرجاع حسابات Python. قم بإرجاع العمليات الحسابية كعناصر Python أو تحويل العمليات الحسابية إلى قيم Excel وإخراجها مباشرة إلى خلية. توضح لقطة الشاشة التالية صيغة Python التي تم إرجاعها كقيمة Excel.

تلميح

يمكنك أيضا استخدام قائمة النقر بزر الماوس الأيمن لتغيير نوع إخراج Python. افتح قائمة النقر بزر الماوس الأيمن وانتقل إلى Python Output، ثم حدد نوع الإخراج المطلوب.

استخدم قائمة إخراج Python للتبديل بين أنواع المخرجات.

توضح لقطة الشاشة التالية نفس صيغة Python كما في لقطة الشاشة السابقة، وتم إرجاعها الآن كعنصر Python. عند إرجاع صيغة كعنصر Python، تعرض الخلية أيقونة بطاقة.

ملاحظة

تتم ترجمة نتائج الصيغ التي يتم إرجاعها إلى قيم Excel إلى أقرب ما يعادلها في Excel. إذا كنت تخطط لإعادة استخدام النتيجة في عملية حسابية ل Python مستقبلية، فمن المستحسن إرجاع النتيجة كعنصر Python. يتيح لك إرجاع نتيجة كقيم Excel تشغيل تحليلات Excel، مثل مخططات Excel والصيغ والتنسيق الشرطي، على القيمة.

عند إرجاع البيانات كعنصر Python، تعرض الخلية أيقونة بطاقة Python.

يحتوي عنصر Python على معلومات إضافية داخل الخلية. لعرض المعلومات الإضافية، افتح البطاقة عن طريق تحديد أيقونة البطاقة. المعلومات المعروضة على البطاقة هي معاينة للعنصر، وهو أمر مفيد عند معالجة العناصر الكبيرة.

يمكن ل Python في Excel إرجاع أنواع عديدة من البيانات كعناصر Python. نوع بيانات Python في Excel المفيد هو عنصر DataFrame. لمعرفة المزيد حول إطارات بيانات Python، راجع Python في Excel DataFrames.

استيراد بيانات خارجية

يجب أن تأتي جميع البيانات التي تعالجها باستخدام Python في Excel من ورقة العمل الخاصة بك أو من خلال Power Query. لاستيراد بيانات خارجية، استخدم ميزة "الحصول على تحويل &" في Excel للوصول إلى Power Query. لمزيد من المعلومات، راجع استخدام Power Query لاستيراد البيانات الخاصة ب Python في Excel.

هام

لحماية أمانك، لا تتوافق وظائف البيانات الخارجية الشائعة في Python، مثل pandas.read_csv و pandas.read_excel، مع Python في Excel. لمعرفة المزيد، راجع أمان البيانات وPython في Excel.

ترتيب العمليات الحسابية

تقوم عبارات Python التقليدية بالحساب من أعلى إلى أسفل. داخل Python في خلية Excel، تقوم عبارات Python بنفس الشيء - فهي تحسب من أعلى إلى أسفل. ولكن في ورقة عمل Python في Excel، تحسب خلايا Python بترتيب الصف الرئيسي. تتم العمليات الحسابية للخلية عبر صف (من العمود A إلى العمود XFD)، ثم عبر كل صف تال أسفل ورقة العمل.

يتم ترتيب عبارات Python، بحيث تحتوي كل جملة Python على تبعية ضمنية على عبارة Python التي تسبقه مباشرة في ترتيب الحساب.

يعد ترتيب العمليات الحسابية مهما عند تعريف المتغيرات والإشارة إليها في ورقة عمل، لأنه يجب تعريف المتغيرات قبل الرجوع إليها.

هام

ينطبق أيضا ترتيب حساب الصف الرئيسي عبر أوراق العمل داخل المصنف ويستند إلى ترتيب أوراق العمل داخل المصنف. إذا كنت تستخدم أوراق عمل متعددة لتحليل البيانات باستخدام Python في Excel، فتأكد من تضمين البيانات وأي متغيرات تخزن البيانات في الخلايا وأوراق العمل التي تسبق الخلايا وأوراق العمل التي تحلل تلك البيانات.

إعادة الحساب

عند تغيير قيمة تابعة لخلية Python، تتم إعادة حساب جميع صيغ Python بشكل تسلسلي. لتعليق عمليات إعادة حسابات Python وتحسين الأداء، استخدم إما وضع الحساب الجزئي أو الحساب اليدوي . تسمح لك هذه الأوضاع بتشغيل عملية حسابية عندما تصبح جاهزا. لتغيير هذا الإعداد، انتقل إلى الشريط وحدد الصيغ، ثم افتح خيارات الحساب. بعد ذلك، حدد وضع الحساب المطلوب. يقوم وضعي الحساب الجزئيوالحساب اليدوي بتعليق إعادة الحساب التلقائي لكل من جداول Python والبيانات.

يمكن أن يؤدي تعطيل إعادة الحساب التلقائي في مصنف أثناء تطوير Python إلى تحسين الأداء وسرعات حساب خلايا Python الفردية. ومع ذلك، يجب عليك إعادة حساب المصنف يدويا لضمان الدقة في كل خلية Python. توجد ثلاث طرق لإعادة حساب مصنف يدويا في وضع الحساب الجزئي أو الحساب اليدوي .

  1. استخدم اختصار لوحة المفاتيح F9.
  2. انتقل إلى الصيغ>حساب الآن في الشريط.
  3. انتقل إلى خلية ذات قيمة قديمة، معروضة بتنسيق يتوسطه خط، وحدد رمز الخطأ إلى جانب تلك الخلية. ثم حدد "الحساب الآن " من القائمة.

أخطاء

يمكن أن ترجع العمليات الحسابية ل Python في Excel أخطاء مثل #PYTHON!، و#BUSY!، و #CONNECT! إلى خلايا Python. لمعرفة المزيد، راجع استكشاف أخطاء Python في Excel وإصلاحها.