حل خطأ str object has no attribute append في بايثون | مشكلة وحل 19

إذا ظهر لك الخطأ AttributeError: 'str' object has no attribute 'append' فالمعنى مباشر: المتغير الذي استدعيت عليه append() هو نص من نوع str، وليس قائمة list. لذلك لا تبحث عن خطأ في append() نفسها؛ ابدأ بفحص نوع المتغير الذي تستخدمها معه.

AttributeError: 'str' object has no attribute 'append'

إذا كنت تريد إضافة عنصر إلى مجموعة عناصر، استخدم قائمة ثم append(). وإذا كنت تريد إضافة نص إلى نص، استخدم + أو += أو f-string، وإذا كنت تجمع أجزاء كثيرة فاستخدم قائمة ثم join(). وإذا جاءت القيمة من input() فتذكر أن input() تعيد نصًا، حتى لو كنت تنوي إضافته لاحقًا إلى قائمة.

في مشكلة وحل 19 سنحدد سبب الخطأ خطوة بخطوة، ونشرح الحالات الأشهر: استخدام append() مع String، استدعاؤها على عنصر نصي داخل List، تغيّر نوع المتغير بعد join() أو الإسناد، تحويل نص إلى List باستخدام split()، وخطأ items = items.append(...).

{alertInfo} الحل المختصر: لا تستخدم append() إلا مع قائمة. افحص نوع المتغير أولًا، ثم اختر بين List أو دمج النصوص حسب ما تريد أن يفعله البرنامج.

{getToc} $title={محتوى المقال}

ما معنى خطأ str object has no attribute append في بايثون؟

قد تختلف الرسالة حسب اسم المتغير، لكن الجزء المهم منها يكون عادة:

AttributeError: 'str' object has no attribute 'append'

لنقسمها إلى أجزاء بسيطة:

جزء الرسالة	معناه
AttributeError	استخدمت خاصية أو دالة غير موجودة لهذا النوع من البيانات.
'str'	القيمة الحالية للمتغير نص من نوع String.
object has no attribute 'append'	النص لا يملك دالة باسم append().

إذن الحل لا يبدأ من حذف append() عشوائيًا؛ بل من الإجابة عن سؤال واحد: هل المتغير الذي أستخدم معه append هو List فعلًا أم String؟

الحل السريع حسب سبب الخطأ

حالتك	الحل الصحيح
لديك String وتريد إضافة نص إليه	استخدم + أو += أو f-string، ولا تستخدم append().
تريد تخزين عناصر متعددة	أنشئ List مثل items = [] ثم استخدم items.append(value).
القيمة جاءت من input()	احتفظ بقائمة منفصلة، ثم أضف إليها ناتج input().
لديك نص يحتوي عناصر مفصولة بفواصل	حوّله إلى قائمة باستخدام split(",") ثم استخدم append().
كتبت items = items.append(value)	احذف الإسناد؛ append() تعدّل القائمة نفسها وتعيد None.

مثال بسيط يسبب الخطأ

انظر إلى هذا الكود:

name = "Ali"

name.append(" Ahmed")

print(name)

سيظهر الخطأ لأن name يحتوي على نص واحد، والنص لا يملك دالة append().

إذا كان المطلوب هو دمج نصين، استخدم + أو += أو f-string. لأبسط حالة يمكن كتابة:

name = "Ali"

name += " Ahmed"

print(name)

Ali Ahmed

لماذا تعمل append مع List ولا تعمل مع String؟

القائمة List نوع قابل للتعديل mutable ومصمم لتخزين عدة عناصر، لذلك تحتوي على دوال مثل append() وextend() وremove(). إذا كانت القوائم ما تزال غير واضحة لديك، راجع أساسيات بايثون 16: شرح Lists في بايثون للمبتدئين.

أما النص String فهو غير قابل للتعديل في مكانه immutable. أي عملية تبدو وكأنها تغيّر النص تنشئ نصًا جديدًا بدل تعديل الكائن النصي نفسه، ولهذا لا توجد فيه append(). وإذا كان سؤالك عن الفرق بين طرق الإضافة إلى القوائم، فراجع الفرق بين append وextend في بايثون.

النوع	مثال	هل append تعمل؟	الاستخدام المناسب
str	"Python"	لا	دمج النصوص باستخدام + أو f-string أو join().
list	["Python", "Java"]	نعم	إضافة عنصر جديد إلى نهاية القائمة.

في توثيق بايثون، list.append(value) تضيف عنصرًا واحدًا إلى نهاية القائمة. أما النصوص فلها Methods مختلفة مثل split() وjoin() ولا تحتوي على append().

لدي List فعلًا، فلماذا يظهر str object has no attribute append؟

وجود قائمة لا يعني أن كل ما بداخلها قائمة أيضًا. من أكثر الحالات ظهورًا في نتائج هذا الخطأ أنك تستدعي append() على عنصر نصي داخل القائمة بدل استدعائها على القائمة نفسها.

مثال خاطئ:

names = ["Ali", "Sara"]

names[0].append(" Ahmed")

المتغير names هو List، لكن names[0] يساوي النص "Ali"، لذلك استدعاء append() عليه يؤدي إلى الخطأ.

إذا أردت إضافة اسم جديد إلى القائمة فاكتب:

names.append("Ahmed")

أما إذا أردت تعديل النص الموجود في العنصر الأول، فأنشئ نصًا جديدًا:

names[0] += " Ahmed"

{alertInfo} نقطة تشخيص مهمة: افحص نوع الكائن الموجود مباشرة قبل .append(). في names[0].append(...) المطلوب فحص type(names[0])، وليس type(names) فقط.

الحل الأول: استخدم List عندما تريد جمع عناصر متعددة

إذا كان هدفك هو تخزين أكثر من اسم أو أكثر من كلمة، أنشئ قائمة من البداية بدل نص واحد:

names = []

names.append("Ali")
names.append("Sara")
names.append("Omar")

print(names)

['Ali', 'Sara', 'Omar']

هنا تعمل append() لأن names قائمة فعلًا، وليست نصًا.

حالة شائعة: كتبت شكل List لكنه داخل علامات اقتباس

هذا الكود يبدو كأنه يحتوي قائمة، لكنه في الحقيقة ينشئ String لأن القيمة كلها بين علامات اقتباس:

items = "['apple', 'banana']"

items.append("cherry")

الحل هو إنشاء List فعلية بدون علامات اقتباس حول البنية كلها:

items = ["apple", "banana"]

items.append("cherry")

إذا لم تكن متأكدًا، استخدم type(items). شكل النص على الشاشة لا يحدد نوعه؛ النوع الفعلي هو الذي يحدد الدوال المتاحة.

الحل الثاني: لا تخزن نتيجة input داخل متغير تتوقع أنه List

من أكثر الأسباب العملية للخطأ أن input() ترجع نصًا دائمًا. حتى لو كتب المستخدم كلمة تبدو كعنصر من قائمة، ستظل النتيجة من نوع str.

مثال خاطئ:

items = input("اكتب عنصرًا: ")

items.append("Python")

إذا كتب المستخدم Book، تصبح قيمة items هي النص "Book"، ولذلك يظهر الخطأ عند السطر الثاني.

الحل أن تحتفظ بقائمة منفصلة، ثم تضيف إليها الإدخال:

items = []

new_item = input("اكتب عنصرًا: ").strip()

if new_item:
    items.append(new_item)

print(items)

في هذا المثال:

• items قائمة تستقبل العناصر.
• new_item نص يمثل الإدخال الجديد.
• نستخدم strip() لإزالة المسافات الزائدة حول الإدخال.
• نضيف النص إلى القائمة باستخدام append().

الحل الثالث: استخدم split لتحويل النص إلى قائمة

أحيانًا يكتب المستخدم عناصر متعددة في سطر واحد، مثل:

Python,Java,JavaScript

هذه القيمة ما زالت نصًا واحدًا. إذا أردت التعامل معها كقائمة عناصر، استخدم split():

text = "Python,Java,JavaScript"

languages = text.split(",")

languages.append("C++")

print(languages)

['Python', 'Java', 'JavaScript', 'C++']

هنا أعادت split(",") قائمة، ولذلك أصبح استخدام append() صحيحًا.

الحل الرابع: ابنِ النص عبر قائمة ثم استخدم join

إذا كنت تجمع أجزاء كثيرة من النص داخل حلقة، قد يكون من الأنظف أن تضع الأجزاء في قائمة ثم تجمعها في النهاية باستخدام join().

مثال خاطئ:

message = ""

for word in ["تعلم", "Python", "بالعربي"]:
    message.append(word)

المتغير message هنا نص فارغ، لذلك ستظهر رسالة AttributeError.

الحل الأفضل:

words = []

for word in ["تعلم", "Python", "بالعربي"]:
    words.append(word)

message = " ".join(words)

print(message)

تعلم Python بالعربي

لاحظ الفرق:

• words قائمة، لذلك يمكن إضافة العناصر إليها.
• join() تجمع عناصر القائمة في نص واحد في النهاية.

سبب شائع آخر: تغيّر نوع المتغير دون أن تنتبه

قد تبدأ المتغير على أنه قائمة، ثم تعطيه قيمة نصية لاحقًا. عندها تصبح append() غير صالحة:

tasks = []

tasks.append("قراءة الدرس")

tasks = "إكمال التمرين"

tasks.append("مراجعة الكود")

في البداية tasks قائمة، لكن في السطر الثالث تحولت إلى نص. لهذا سيظهر الخطأ في السطر الأخير.

استخدم أسماء واضحة ومختلفة عندما تمثل القيم أشياء مختلفة:

tasks = ["قراءة الدرس"]

current_task = "إكمال التمرين"

tasks.append(current_task)

print(tasks)

حالة شائعة: استخدمت join ثم حاولت append على نفس المتغير

الدالة join() تعيد String. لذلك إذا كان المتغير List ثم خزنت فيه ناتج join()، فقد تغيّر نوعه دون أن تنتبه:

languages = ["Python", "Java"]

languages = ", ".join(languages)

languages.append("C++")

بعد سطر join() أصبحت languages نصًا مثل "Python, Java". إذا كنت تحتاج القائمة لاحقًا، لا تستبدلها بالنص؛ استخدم متغيرًا آخر:

languages = ["Python", "Java"]

languages_text = ", ".join(languages)

languages.append("C++")

كيف تشخص المشكلة بسرعة؟

قبل السطر الذي يظهر فيه الخطأ، اطبع القيمة التي تسبق .append() مباشرة ونوعها. إذا كان السطر items.append(...) افحص items، وإذا كان items[0].append(...) افحص items[0]:

print(items)
print(type(items))

إذا ظهر لك:

Book
<class 'str'>

فهذا تأكيد أن items نص وليست قائمة. يمكنك أيضًا استخدام isinstance() عندما تريد التحقق داخل كود حقيقي:

if isinstance(items, list):
    items.append("Python")
else:
    print("المتغير ليس قائمة.")

إذا كان نوع المتغير صحيحًا لكن اسم الدالة غير مناسب لنوع البيانات، فهذه هي الفكرة نفسها وراء أخطاء AttributeError الأخرى؛ مثال قريب هو خطأ list object has no attribute lower، حيث تُستخدم دالة نصية على List بدل String.

أخطاء قريبة من هذه المشكلة

1. استخدام append مع tuple

القيم من نوع tuple لا تملك append() أيضًا، لأنها غير قابلة للتعديل.

colors = ("red", "blue")

colors.append("green")

إذا كنت تحتاج الإضافة، استخدم قائمة بدل tuple:

colors = ["red", "blue"]

colors.append("green")

2. تخزين ناتج append داخل المتغير نفسه

هذه مشكلة مختلفة لكنها شائعة جدًا:

names = ["Ali", "Sara"]

names = names.append("Omar")

print(names)

الدالة append() تعدل القائمة نفسها ولا ترجع قائمة جديدة، لذلك تصبح قيمة names هي None. هذا قد يقود لاحقًا إلى خطأ مختلف من نوع NoneType object has no attribute. إذا واجهته، راجع مشكلة وحل 27: خطأ NoneType object has no attribute. اكتب الكود هكذا بدلًا من ذلك:

names = ["Ali", "Sara"]

names.append("Omar")

print(names)

دوال القوائم التي تعدّل القائمة في مكانها، ومنها append()، تعيد None بدل إعادة القائمة نفسها. لذلك افصل عملية الإضافة عن الإسناد إلى المتغير.

خطوات الحل السريع

1. اقرأ الجزء 'str' داخل رسالة الخطأ؛ فهو يخبرك بنوع المتغير الحالي.
2. ابحث عن المتغير قبل سطر الخطأ، وتأكد أين حصل على قيمته.
3. استخدم type(variable) إذا لم تكن متأكدًا من نوعه، وافحص العنصر نفسه إذا كانت append() مستدعاة على list[index].
4. تأكد أنك لم تكتب شكل القائمة داخل علامات اقتباس، ولم تستبدل القائمة بناتج join().
5. إذا كنت تريد تخزين عناصر متعددة، ابدأ بقائمة [].
6. إذا كنت تريد دمج نصوص، استخدم + أو += أو f-string أو join().
7. لا تكتب items = items.append(value).

مثال عملي كامل: برنامج بسيط لجمع أسماء

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

names = []

while True:
    name = input("اكتب اسمًا، أو اضغط Enter للانتهاء: ").strip()

    if not name:
        break

    names.append(name)

if names:
    print("الأسماء:", ", ".join(names))
else:
    print("لم تتم إضافة أسماء.")

في هذا المثال نستخدم كل أداة في مكانها الصحيح:

• input() يعيد نصًا واحدًا.
• names قائمة تخزن عدة نصوص.
• append() تضيف كل نص جديد إلى القائمة.
• join() تجمع القائمة في نص واحد للعرض النهائي.

بعد أن تصلح الخطأ، يمكنك تثبيت الفكرة بالتطبيق من خلال تمارين Lists في بايثون مع الحلول، وخصوصًا تمارين الإضافة والتعديل على القوائم.

الخلاصة

• رسالة 'str' object has no attribute 'append' تعني أن المتغير نص وليس قائمة.
• استخدم append() لإضافة عنصر إلى List فقط.
• استخدم + أو f-string أو join() عندما تتعامل مع النصوص.
• تذكر أن input() ترجع str دائمًا.
• استخدم type() أو isinstance() لمعرفة نوع المتغير عند تشخيص الخطأ.
• لا تخزن ناتج append() في المتغير نفسه لأنها لا ترجع قائمة جديدة.

{alertSuccess} قاعدة ذهبية: قبل كتابة variable.append(...)، تأكد أن variable قائمة فعلًا. وإذا كان نصًا، اسأل: هل أريد دمج نص؟ أم أريد جمع عدة عناصر داخل قائمة؟

مصادر خارجية رسمية للتوسع

• Python Tutorial: Data Structures
• Built-in Types — Python Documentation
• Common String Operations — Python Documentation

أسئلة شائعة

ما معنى str object has no attribute append في Python؟

يعني أن المتغير الذي استخدمت معه append() نص من نوع str، بينما append() دالة خاصة بالقوائم list.

هل يمكن إضافة نص إلى String باستخدام append؟

لا. استخدم دمج النصوص مثل text += "new" أو text = text + "new" أو f-string. وإذا كنت تجمع أجزاء كثيرة، ضعها في List ثم استخدم join().

لماذا يظهر الخطأ رغم أن المتغير الأساسي List؟

قد تكون استدعيت append() على عنصر داخل القائمة وليس على القائمة نفسها. مثل names[0].append(...): إذا كان names[0] نصًا، فسيظهر نفس الخطأ. افحص type(names[0]) في هذه الحالة.

لماذا يظهر الخطأ بعد input؟

لأن input() ترجع نصًا دائمًا، حتى لو أدخل المستخدم رقمًا أو كلمة. أنشئ قائمة منفصلة ثم أضف ناتج input إليها.

هل append ترجع قائمة جديدة؟

لا. الدالة append() تعدل القائمة الحالية في مكانها وترجع None. لذلك لا تكتب items = items.append(value).

كيف أعرف هل المتغير String أو List؟

استخدم print(type(variable)). إذا ظهر <class 'str'> فهو نص، وإذا ظهر <class 'list'> فهو قائمة.