> https://learn.abdulosama.com/qamoos/refactoring

![رسم توضيحي يشرح Refactoring (إعادة الهيكلة): إعادة الهيكلة ترتيب الكود من الداخل دون تغيير ما يفعله من الخارج.](https://learn.abdulosama.com/images/guide/refactoring.webp)

# Refactoringإعادة الهيكلة

## ما هو Refactoring؟

إعادة الهيكلة ترتيب الكود من الداخل دون تغيير ما يفعله من الخارج.

## ما معنى Refactoring بالعربي؟

الاسم المعتمد الآن هو «**إعادة الهيكلة** ». ولأن كثيرًا من المصطلحات لم يستقرّ لها اسم عربي واحد، يكتب هذا القاموس قرّاؤه: صوّت للاسم الذي تراه أوضح، أو اقترح اسمًا أفضل. نراجع الأصوات في كل جولة ونعتمد ما يختاره الناس.

1. إعادة الهيكلة الاسم المعتمد اسم القاموس
2. ريفاكتور تعريب صوتي شائع بين المطورين
3. تحسين بنية الكود وصف مبسّط شائع
4. إعادة كتابة الكود تعبير دارج بين المطورين

صوت واحد لكل قارئ في كل مصطلح، وتستطيع نقله إلى اسم آخر. حين يتجاوز اسمٌ الاسمَ المعتمد ويصل إلى 5 أصوات على الأقل، نعرضه للاعتماد في الجولة التالية.

اقترح اسمًا عربيًا أفضل هل الشرح غير واضح أو فيه خطأ؟

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

إعادة الهيكلة (Refactoring) هي يوم الإغلاق هذا. تغيّر طريقة تنظيم الكود من الداخل، ولا تغيّر أبدًا ما يفعله من الخارج: الأزرار نفسها، والسلوك نفسه، والنتيجة نفسها لمن يستخدمه. ما يتحسّن هو سهولة العمل فيه في المرّة القادمة.

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

لماذا تتعب على شيء لا يراه أحد؟ لأنّ الكود الفوضويّ يأخذ منك إيجارًا بصمت. النسخة الأولى من أيّ شيء نادرًا ما تكون نظيفة؛ تضيف قطعة وأنت تكتشف، ثم قطعة فوقها. وبعد ستّة أشهر يمسّ تعديل «صغير» أحد عشر موضعًا وتخاف أن تحرّك أيًّا منها. المطعم يعمل، لكنّك تخشى الدخول إلى مطبخه.

وحين تبني بالوكيل تصبح إعادة الهيكلة مهمّتك أنت، لا المطوّر وحده. تصف ما تريد، فيكتبه، فتنتقل إلى التالي. كرّر ذلك أسبوعًا وعندك كومة تعمل لكنّها مربوطة بشريط لاصق؛ النموذج حسّن لـ «اجعله يعمل» لا لـ «اجعله مريحًا للعيش». فتوقّف بين حين وآخر وقل: «هذا يعمل. قبل أن نضيف أيّ شيء، رتّب الكود دون تغيير ما يفعله. السلوك نفسه، لكن أوضح وأسهل متابعة». وستجني الثمرة فورًا، لأنّ الكود المرتّب يتنقّل فيه الوكيل نفسه أفضل. والشرط الحقيقيّ قبل الترتيب هو وجود اختبارات ([Test](https://learn.abdulosama.com/qamoos/test-unit-test) / Unit Test) تثبت أنّ القائمة لم تتغيّر.

قاعدتان: صغيرًا ومتكرّرًا، لا ضخمًا ولا أبدًا؛ المحترفون لا يحجزون «أسبوع إعادة هيكلة»، بل يرتّبون في جولات قصيرة قبل أن تتراكم الفوضى. وهي ليست إضافة ميزة ولا إصلاح خلل، بل الشيء الثالث الذي يُنسى: جعل الموجود أسهل تغييرًا.

## لماذا يهمك Refactoring؟

ستفهم فاتورة لا تحمل ميزة جديدة ومع ذلك تستحقّ الدفع، وستطلبها بنفسك من الوكيل قبل أن يتحوّل مشروعك إلى مطبخ يخشاه الجميع.

## متى ستسمع كلمة Refactoring؟

يقول لك المطوّر: «قبل أن نضيف الدفع بالتقسيط، أحتاج يومين لإعادة هيكلة ملفّ الطلبات».

## كلمات قريبة

- [Technical Debt · الدَّين التقنيّ](https://learn.abdulosama.com/qamoos/technical-debt)
- [DRY · لا تكرّر نفسك](https://learn.abdulosama.com/qamoos/dry)
- [KISS · أبقِه بسيطًا](https://learn.abdulosama.com/qamoos/kiss)
- [Test / Unit Test · الاختبار واختبار الوحدة](https://learn.abdulosama.com/qamoos/test-unit-test)

## حمّل القاموس كاملًا بصيغة PDF

قاموس التقنية بالعربي: 101 مصطلحًا في كتاب واحد مصوّر، تقرؤه على هاتفك أو تطبعه. اكتب اسمك ورقم واتساب، وتنضمّ إلى قائمة عبدول على واتساب، ويظهر لك رابط التحميل فورًا.

**تمّ.** انضممت إلى القائمة، وهذا رابط القاموس. يعمل الرابط سبعة أيام، فاحفظ الملف على جهازك.

تحميل القاموس (PDF)

لن نشارك رقمك مع أحد. يمكنك الخروج من القائمة في أي وقت.

## تريد إضافته إلى موقعك؟

أداة مجانية لموقعك أو مدونتك: يظهر خط منقّط تحت مصطلحات القاموس في مقالاتك، ومن يمرّ عليها يرى اسمها العربي ومعناها، ورابطًا للشرح الكامل في صفحة جديدة. لا تجمع أي بيانات عن زوّارك.

1. **الصق هذا السطر** قبل نهاية صفحات موقعك (قبل `</body>`):
`<script src="https://learn.abdulosama.com/qamoos/embed.js" defer></script>`
2. **أو اطلب ذلك من وكيل الذكاء الاصطناعي** الذي يبني موقعك (Claude Code أو Cursor أو غيرهما): انسخ هذه الجملة وأرسلها له.
`أضف أداة «قاموس التقنية بالعربي» إلى موقعي، واتبع التعليمات هنا: https://learn.abdulosama.com/qamoos/install.md`
3. **دليل التثبيت** لووردبريس وShopify وWebflow وNext.js وغيرها: [افتحه ↗](https://learn.abdulosama.com/qamoos/install.md)