مسرد مصطلحات الترجمة

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

المصطلحات المعتمدة

المصطلح الإنجليزي	المقابل العربي	ملاحظات الاستخدام
Go	لغة Go	يبقى الاسم Go بالإنجليزية
example	مثال	جمعها: أمثلة
program	برنامج	—
source code	الكود المصدري	يمكن استخدام «الكود» بعد وضوح السياق
compiler	مترجم	المقصود مترجم الكود البرمجي
executable / binary	ملف تنفيذي	لا تترجم اسم الملف نفسه
value	قيمة	—
zero value	قيمة صفرية	القيمة الافتراضية لنوع غير مهيأ
variable	متغير	—
constant	ثابت	—
initialization	تهيئة	—
type	نوع	—
integer	عدد صحيح	—
floating-point number	عدد فاصلة عائمة	—
boolean	قيمة منطقية	يبقى النوع bool داخل الكود
operator	معامل	مثل المعامل المنطقي أو الحسابي
condition	شرط	—
loop	حلقة تكرار	—
sequence	تسلسل	—
data structure	هيكل بيانات	جمعها: هياكل بيانات
associative data type	نوع بيانات ترابطي	مثل الخرائط التي تربط المفاتيح بالقيم
field	حقل	مثل حقل في هيكل
built-in type	نوع مدمج	لا تستخدم «نوع مضمن» لتجنب الخلط مع embedding
array	مصفوفة	—
slice	شريحة	—
index	فهرس	—
length	طول	تقابله الدالة len في السياق البرمجي
capacity	سعة	تقابلها الدالة cap في سياق الشرائح
map	خريطة	يبقى النوع map بالإنجليزية عند الإشارة إلى الصياغة البرمجية
key	مفتاح	المفتاح المستخدم للوصول إلى قيمة في خريطة
key/value pair	زوج مفتاح وقيمة	جمعها: أزواج المفاتيح والقيم
blank identifier	المعرّف الفارغ	أبقِ المعرّف _ داخل الكود
pointer	مؤشر	—
reference	مرجع	—
memory address	عنوان ذاكرة	—
dereference	فك الإشارة	مثل فك إشارة المؤشر باستخدام *p
string	سلسلة نصية	يبقى النوع string داخل الكود
rune	محرف rune	يبقى النوع rune بالإنجليزية
byte	بايت	يبقى النوع byte داخل الكود
Unicode code point	نقطة ترميز Unicode	—
literal	قيمة حرفية	مثل قيمة حرفية من النوع rune
offset	إزاحة	موضع نسبي داخل سلسلة نصية أو بنية بيانات
function	دالة	—
parameter	مُعامِل	المدخل المعلن في توقيع الدالة؛ يختلف عن الوسيط الممرر عند الاستدعاء
function signature	توقيع دالة	—
return value	قيمة إرجاع	—
multiple assignment	إسناد متعدد	إسناد عدة قيم في تعليمة واحدة
variadic function	دالة متغيرة عدد الوسائط	—
anonymous function	دالة مجهولة	دالة معرّفة دون اسم
closure	إغلاق	—
recursion	استدعاء ذاتي	—
base case	حالة أساسية	الحالة التي توقف الاستدعاء الذاتي
pass by value	تمرير بالقيمة	تمرير نسخة من القيمة إلى الدالة
struct	هيكل	يبقى struct عند الإشارة إلى الكلمة المحجوزة
anonymous struct	هيكل مجهول	هيكل معرّف دون اسم نوع مستقل
constructor function	دالة إنشاء	دالة تنشئ قيمة جديدة وتهيئها
garbage collection	جمع المهملات	والمنفذ: جامع المهملات
mutable	قابل للتغيير	—
method	أسلوب	—
receiver	مستقبِل	القيمة أو المؤشر الذي يعرّف عليه الأسلوب
interface	واجهة	يبقى interface عند الإشارة إلى الكلمة المحجوزة
type assertion	تأكيد النوع	مثل v.(T)
enum	تعداد	—
sum type	نوع مجموعي	—
underlying type	نوع أساسي	النوع الذي يستند إليه نوع معرّف
embedding	تضمين	مثل «تضمين الهياكل»
composition	تركيب	تركيب الأنواع من أنواع أصغر
generics	الأنواع العامة	—
type parameter	مُعامِل نوع	جمعها: مُعامِلات الأنواع
constraint	قيد	مثل القيد comparable
type inference	استنتاج النوع	استنتاج المترجم للنوع من السياق
linked list	قائمة مترابطة	ومنها القائمة أحادية الربط
iterator	مكرر	—
early termination	إنهاء مبكر	إيقاف الاجتياز قبل استنفاد العناصر
error	خطأ	—
custom error	خطأ مخصص	—
exception	استثناء	للمقارنة مع معالجة الأخطاء في لغات أخرى
sentinel error	خطأ دالّ	متغير خطأ معلن مسبقًا يدل على حالة محددة
error wrapping	تغليف الخطأ	إضافة سياق مع الاحتفاظ بالخطأ الأصلي
error chain	سلسلة أخطاء	سلسلة الأخطاء الناتجة عن التغليف
lightweight thread	خيط تنفيذ خفيف الوزن	يُستخدم في تعريف روتين Go
concurrent / concurrency	متزامن / تزامن	تنفيذ مهام متداخلة زمنيًا، وليس بالضرورة بالتوازي
synchronous	متزامن	تنفيذ ينتظر اكتمال العملية قبل المتابعة؛ يُفهم الفرق من السياق
asynchronous	غير متزامن	تنفيذ لا ينتظر اكتمال العملية قبل المتابعة
blocking	حاجز	عملية توقف تقدم روتين Go حتى تصبح جاهزة
send / receive	إرسال / استقبال	عمليتا تمرير القيم عبر القنوات
sender / receiver	مرسل / مستقبِل	طرفا عملية الاتصال عبر قناة
buffer	مخزن مؤقت	مساحة تحتفظ بالقيم داخل قناة مخزنة مؤقتًا
runtime	بيئة تشغيل	مثل بيئة تشغيل Go
goroutine leak	تسرب روتين Go	بقاء روتين Go محجوبًا بعد انتفاء الحاجة إليه
goroutine	روتين Go	يمكن ذكر goroutine عند أول ظهور
channel	قناة	يبقى النوع chan داخل الكود
buffered channel	قناة مخزنة مؤقتًا	—
closed channel	قناة مغلقة	قناة لن تُرسل إليها قيم أخرى
synchronization	مزامنة	—
channel direction	اتجاه القناة	إرسال أو استقبال
type safety	أمان الأنواع	اكتشاف الاستخدامات غير الصحيحة للأنواع أثناء الترجمة
non-blocking	غير حاجز	مثل «عملية غير حاجزة»
timeout	مهلة زمنية	—
timer	مؤقت	—
ticker	مؤقت دوري	—
time interval	فاصل زمني	مدة تفصل بين حدثين متكررين
timer fires	ينطلق المؤقت	عند إرسال المؤقت قيمة عبر قناته بعد انقضاء مدته
tick	نبضة	القيمة الدورية التي يرسلها المؤقت الدوري
worker pool	مجموعة عمال	—
WaitGroup	مجموعة انتظار	أبقِ المعرّف WaitGroup عند الإشارة إلى API
rate limiting	تحديد المعدل	—
resource utilization	استخدام الموارد	—
quality of service	جودة الخدمة	—
burst	دفعة	مجموعة طلبات قصيرة يُسمح بمعالجتها فورًا
atomic	ذري	مثل «عداد ذري»
atomic operation	عملية ذرية	عملية تتم كوحدة واحدة لا تتداخل معها عملية أخرى
data race	تسابق البيانات	وصول متزامن غير آمن إلى البيانات، مع وجود عملية كتابة واحدة على الأقل
mutex	قفل الاستبعاد المتبادل	يمكن ذكر mutex عند أول ظهور
lock / unlock	قفل / فتح القفل	عمليتا حيازة قفل الاستبعاد المتبادل وتحريره
shared state	حالة مشتركة	حالة تصل إليها عدة روتينات Go
ownership	ملكية	تخصيص روتين Go واحد لإدارة جزء من البيانات
stateful	ذو حالة	—
sorting	فرز	—
natural order	ترتيب طبيعي	الترتيب الافتراضي لقيم نوع ما
comparison function	دالة مقارنة	دالة تحدد ترتيب قيمتين
panic	الدالة panic	أبقِ panic داخل الكود
fail fast	الإخفاق السريع	إيقاف التنفيذ فور اكتشاف خطأ غير قابل للمعالجة
defer	الكلمة defer	أبقِ defer داخل الكود
cleanup	تنظيف الموارد	مثل إغلاق الملفات وتحرير الموارد
recover	الدالة recover	أبقِ recover داخل الكود
goroutine trace	تتبع روتين Go	معلومات مكدس الاستدعاءات المطبوعة عند panic
non-zero exit status	حالة خروج غير صفرية	تدل عادة على فشل البرنامج
formatting	تنسيق	—
printing verb	فعل طباعة	مثل %v و%s في الحزمة fmt
width / precision	عرض / دقة	للتحكم في شكل القيمة المنسقة
scientific notation	التدوين العلمي	مثل تنسيق %e و%E
justification	محاذاة	إلى اليمين أو اليسار داخل عرض محدد
template	قالب	—
dynamic content	محتوى ديناميكي	محتوى يتغير وفق البيانات المقدمة
template action	إجراء قالب	تعبير محاط بـ{{...}} داخل قالب
exported field	حقل مصدّر	يبدأ اسمه بحرف إنجليزي كبير ويمكن للقالب الوصول إليه
whitespace	مسافات بيضاء	المسافات وعلامات الجدولة وفواصل الأسطر
regular expression	تعبير نمطي	يمكن ذكر regexp عند الإشارة إلى الحزمة
pattern	نمط	الصيغة التي يطابقها التعبير النمطي
match / submatch	تطابق / تطابق فرعي	نتيجة النمط الكامل أو مجموعة داخله
parsing	تحليل	مثل «تحليل الأرقام»
encoding	ترميز	—
decoding	فك الترميز	تحويل تمثيل مثل JSON أو XML إلى قيم Go
struct tag	وسم حقل هيكل	مثل json:"name" وxml:"name"
XML element / attribute	عنصر XML / سمة XML	السمة جزء من وسم العنصر وليست عنصرًا متداخلًا
streaming	معالجة متدفقة	قراءة البيانات أو كتابتها مباشرة دون تجميعها كاملة أولًا
duration	مدة زمنية	تبقى time.Duration عند الإشارة إلى النوع
time zone	منطقة زمنية	تبقى time.Location عند الإشارة إلى النوع
Unix epoch	حقبة Unix	نقطة بدء قياس وقت Unix
time layout	تخطيط الوقت	النمط المرجعي الذي تستخدمه Format وParse
reference time	وقت مرجعي	القيمة Mon Jan 2 15:04:05 MST 2006 في حزمة time
pseudorandom number	عدد شبه عشوائي	عدد تولده خوارزمية معروفة الحالة الداخلية
seed	بذرة	قيمة تهيئة لمولد الأعداد شبه العشوائية
numeric base	أساس عددي	مثل الأساس 10 أو 16
URL scheme	مخطط URL	مثل https أو postgres
host / port	مضيف / منفذ	اسم المضيف ورقم المنفذ في عنوان URL
query parameter	مُعامِل استعلام	زوج مفتاح وقيمة في استعلام URL
URL fragment	جزء URL	الجزء الواقع بعد #
hash	بصمة	أبقِ أسماء الخوارزميات مثل SHA-256
hash function	دالة بصمة	دالة تحوّل البيانات إلى بصمة ثابتة الطول
cryptographically secure	آمن تشفيريًا	يتطلب اختيار خوارزمية مناسبة ودراسة قوتها
data blob	كتلة بيانات	مجموعة بيانات ثنائية أو نصية
well-formed	سليم الصياغة	مدخلات تتبع قواعد الصيغة المطلوبة
buffered I/O	إدخال وإخراج مخزن مؤقتًا	تجميع عمليات صغيرة لتحسين الكفاءة
seek	انتقال داخل ملف	تغيير موضع القراءة أو الكتابة باستخدام Seek
file cursor	مؤشر ملف	الموضع الحالي للقراءة أو الكتابة
flush	تفريغ	دفع البيانات المخزنة مؤقتًا إلى الكاتب الأساسي
stable storage	تخزين دائم	تخزين تُزامن إليه البيانات باستخدام Sync
line filter	مرشح أسطر	برنامج يقرأ الأسطر ويعالجها ثم يكتب النتيجة
standard input / output	الإدخال / الإخراج القياسي	أبقِ stdin وstdout داخل الكود
end of file	نهاية الملف	يمكن استخدام الاختصار EOF في السياق التقني
file path	مسار ملف	—
portable	قابل للنقل	يعمل عبر أنظمة تشغيل مختلفة
path normalization	تطبيع المسار	إزالة الفواصل والمكونات الزائدة من المسار
path separator	فاصل مسار	/ على أنظمة Unix و\ على Windows
absolute / relative path	مسار مطلق / نسبي	المسار النسبي يُفسر نسبة إلى موضع أساس
file extension	امتداد ملف	الجزء اللاحق للنقطة في اسم الملف
directory	مجلد	—
directory tree	شجرة مجلدات	مجلد وما يحتويه من مجلدات فرعية
callback function	دالة رد نداء	دالة تُمرر إلى دالة أخرى لتستدعيها لاحقًا
file permissions	أذونات ملف	مثل 0644 و0755 في أمثلة الملفات
temporary file	ملف مؤقت	—
temporary directory	مجلد مؤقت	مجلد للبيانات التي لا تلزم بعد انتهاء البرنامج
embed directive	توجيه embed	أبقِ embed بالإنجليزية
compiler directive	توجيه للمترجم	تعليمة خاصة يعالجها مترجم Go
blank import	استيراد فارغ	استيراد بالحرف _ لتشغيل تهيئة الحزمة فقط
wildcard	محرف بدل	مثل * في أنماط الملفات
virtual file system	نظام ملفات افتراضي	مثل النوع embed.FS
test	اختبار	—
unit test	اختبار وحدة	اختبار لوحدة صغيرة من سلوك البرنامج
subtest	اختبار فرعي	اختبار يُشغّل باستخدام t.Run
benchmark	قياس أداء	—
benchmark runner	مشغّل قياس الأداء	ينفذ متن القياس مرات كافية لتقدير الأداء
verbose mode	الوضع التفصيلي	مثل الخيار -v مع go test
table-driven test	اختبار قائم على جدول	جمعها: اختبارات قائمة على جداول
command line	سطر الأوامر	—
argument	وسيط	جمعها: وسائط
positional argument	وسيط موضعي	وسيط يُفسر حسب موضعه لا حسب اسم خيار
raw argument	وسيط خام	وسيط كما ورد في سطر الأوامر قبل تحليله
flag	خيار	أبقِ الخيار نفسه مثل -name دون ترجمة
default value	قيمة افتراضية	القيمة المستخدمة عند عدم توفير خيار أو إعداد
subcommand	أمر فرعي	—
environment variable	متغير بيئة	أبقِ اسم المتغير بالإنجليزية
configuration	إعداد	معلومات تضبط سلوك البرنامج
logging	تسجيل الأحداث	—
logger	مسجّل أحداث	كائن يصدر رسائل السجل
structured logging	تسجيل أحداث منظم	خرج سجل يحتوي حقولًا مثل أزواج المفتاح والقيمة
log prefix	بادئة سجل	نص يميز خرج مسجّل عن غيره
output target	هدف خرج	كائن io.Writer يستقبل الخرج
client	عميل	—
server	خادم	—
HTTP request / response	طلب HTTP / استجابة HTTP	—
response status / body	حالة الاستجابة / جسم الاستجابة	مكونان من استجابة HTTP
handler	معالج	كائن أو دالة تعالج طلب HTTP
adapter	مهايئ	مثل http.HandlerFunc الذي يكيّف دالة لتطبيق واجهة
route	مسار	مسار URL مسجّل لدى خادم HTTP
router	موجّه	يربط مسارات الطلبات بمعالجاتها
HTTP header	ترويسة HTTP	بيانات وصفية في طلب HTTP أو استجابته
listener	مستمع	كائن يقبل اتصالات الشبكة الواردة
socket	مقبس	نقطة اتصال شبكية
network interface	واجهة شبكة	اتصال الجهاز بشبكة معينة
context	سياق	أبقِ context.Context عند الإشارة إلى النوع
deadline	موعد نهائي	وقت ينبغي إكمال العملية أو إلغاؤها عنده
cancellation	إلغاء	إيقاف العمل الجاري عبر السياق
request-scoped value	قيمة ذات نطاق الطلب	قيمة ترافق طلبًا واحدًا عبر الاستدعاءات
API boundary	حد واجهة برمجية	الحد بين مكونات تتواصل عبر واجهات برمجية
process	عملية	—
external process	عملية خارجية	برنامج مستقل تشغله عملية Go
spawn process	تشغيل عملية جديدة	بدء عملية خارجية مع بقاء عملية Go الحالية
pipe	أنبوب	قناة إدخال أو إخراج بين عمليتين
return code	رمز إرجاع	رقم يبين نجاح العملية أو فشلها عند الخروج
exec	استبدال العملية	إحلال عملية أخرى محل العملية الحالية
fork	الدالة fork	لا توفر Go دالة Unix fork مباشرة
signal	إشارة	—
Unix signal	إشارة Unix	مثل SIGINT وSIGTERM
graceful shutdown	إيقاف سلس	إنهاء العمل مع تحرير الموارد وإكمال ما يلزم
exit	خروج	—
exit status	حالة خروج	رقم يبين نتيجة انتهاء البرنامج

عناصر لا تُترجم

• الكلمات المحجوزة وصياغة Go، مثل for وif وswitch وrange وselect وgo وdefer.
• أسماء الحزم والدوال والأنواع والمعرّفات، مثل fmt.Println وhttp.Client وcontext.Context.
• الأوامر وخياراتها والمسارات وأسماء الملفات ومتغيرات البيئة.
• الخرج المتوقع من البرامج، ما لم يتغير المثال الأصلي نفسه.
• الاختصارات وأسماء الصيغ والبروتوكولات، مثل JSON وXML وURL وHTTP وTCP وSHA-256 وBase64.

أسلوب الكتابة

• استخدم العربية الفصحى المعاصرة وجملًا مباشرة وقصيرة نسبيًا.
• ترجم المعنى التقني، ولا تلتزم بالتركيب النحوي الإنجليزي إذا أصبحت العربية ثقيلة.
• استخدم الفاصلة العربية ، وعلامة الاستفهام العربية ؟ في النثر.
• استخدم الأرقام 0-9 عندما ترتبط بالكود أو الخرج أو الإصدارات.
• ضع المصطلحات البرمجية ضمن تنسيق الكود لحمايتها من إعادة ترتيب الاتجاه، مثل range وnil.
• اكتب عنوان المثال بالعربية أولًا، وأضف بين قوسين الصيغة الإنجليزية المعتمدة في Go عند أول عنوان يقدّم الكلمة أو النوع أو المفهوم، مثل «الشرائح (slice)» و«الخرائط (map)» و«الدوال (func)». لا تكرر الصيغة الإنجليزية في عناوين الدروس اللاحقة التي تستخدم المفهوم نفسه.
• تجنب التعريب الصوتي إذا كان هناك مقابل عربي واضح، وتجنب ابتكار أكثر من مقابل للمفهوم نفسه.
• لا تضف محارف تحكم ثنائية الاتجاه مخفية؛ استخدم Markdown أو HTML الدلالي لعزل النص التقني عند الحاجة.

إضافة مصطلح جديد

عند ظهور مصطلح غير موجود هنا:

1. راجع استخدامه في توثيق Go والسياق البرمجي للمثال.
2. اختر مقابلًا عربيًا واضحًا وقابلًا للاستخدام في جملة.
3. أضفه إلى هذا الجدول مع ملاحظة توضح ما يجب أن يبقى بالإنجليزية.
4. استخدم المصطلح نفسه في المثال وعنوانه وجدول التقدم إن كان ظاهرًا فيها.