كيفية تثبيت Zero على macOS وLinux وWindows

Q: كيف أُثبّت Zero؟

شغّل سكربت التثبيت الرسمي: curl -fsSL https://zerolang.ai/install.sh | bash. يُنزّل المترجم الجاهز إلى ~/.zero/bin/zero. أضف هذا المسار إلى PATH ثم شغّل zero --version للتأكّد من التثبيت.

Q: أين يُثبَّت Zero؟

سكربت التثبيت يضع كل شيء تحت ~/.zero/. الملف التنفيذي zero يعيش في ~/.zero/bin/zero. لا شيء يُثبَّت على مستوى النظام — لا sudo، ولا /usr/local/، ولا حالة لمدير الحزم. لإلغاء التثبيت، تحذف مجلد ~/.zero.

Q: كيف أتحقّق من أن Zero مثبَّتة بشكل صحيح؟

شغّل zero --version من طرفية جديدة. إذا طبع نصّ إصدار، فقد نجح التثبيت وتمّ ضبط PATH. إذا حصلت على 'command not found'، فإن الملف التنفيذي ليس على PATH بعد — أعد تشغيل سطر export PATH="$HOME/.zero/bin:$PATH" وأضفه إلى ملف بدء تشغيل صدفتك.

Q: كيف أُلغي تثبيت Zero؟

احذف مجلد التثبيت: rm -rf ~/.zero. ثم احذف سطر export PATH="$HOME/.zero/bin:$PATH" الذي أضفته إلى ~/.zshrc أو ~/.bashrc. لا يوجد أمر إلغاء تثبيت منفصل لأن التثبيت لا يلمس سوى ~/.zero وملف rc الخاص بصدفتك.

تثبيت بسطر واحد

أسرع طريقة للحصول على Zero هي سكربت التثبيت الرسمي:

curl -fsSL https://zerolang.ai/install.sh | bash

يُنزّل السكربت مترجمًا جاهزًا لمنصّتك ويضعه تحت ~/.zero/. الملف التنفيذي نفسه ينتهي في ~/.zero/bin/zero. لا شيء يُكتب خارج مجلد المنزل الخاص بك — لا sudo، ولا تغييرات على مستوى النظام.

إذا فضّلت فحص السكربت قبل تشغيله، اجلبه أوّلًا دون توجيهه إلى الصدفة:

curl -fsSL https://zerolang.ai/install.sh -o zero-install.sh
less zero-install.sh
bash zero-install.sh

هذه عادة جيّدة لأي تثبيت بـ curl | bash، وخاصة لمشروع تجريبي.

أضف Zero إلى PATH

يُخبرك سكربت التثبيت بالخطوة التالية، لكن لا بأس بتكرارها. أضف ~/.zero/bin إلى PATH كي تستطيع تشغيل zero من أي مجلد:

export PATH="$HOME/.zero/bin:$PATH"

لجعل هذا دائمًا، أضف السطر نفسه إلى ملف بدء تشغيل الصدفة الذي تستخدمه:

zsh (الافتراضي على macOS الحديث): ~/.zshrc
bash: ~/.bashrc (لينكس) أو ~/.bash_profile (macOS القديم)
fish: أضف fish_add_path $HOME/.zero/bin إلى ~/.config/fish/config.fish

بعد تعديل الملف، افتح نافذة طرفية جديدة أو شغّل source ~/.zshrc (أو ما يماثله) كي يأخذ PATH الجديد مفعوله في الجلسة الحالية.

تحقّق من التثبيت

في طرفية جديدة، اسأل Zero عن إصدارها:

zero --version

ستظهر لك سلسلة إصدار. إذا حصلت على command not found، فإن الملف التنفيذي ليس على PATH بعد — تأكّد من سطر export السابق وأكّد أن ~/.zero/bin/zero موجود فعلًا:

ls -l ~/.zero/bin/zero

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

ملاحظات بحسب المنصّة

macOS

على macOS حديث (Apple Silicon أو Intel) سكربت التثبيت "يعمل ببساطة" مع zsh الافتراضي. في المرة الأولى التي تشغّل فيها zero قد تحتاج للسماح له بتجاوز Gatekeeper — إعدادات النظام ← الخصوصية والأمان ← "السماح على أي حال". بعد هذه الضغطة الواحدة سيعمل بشكل طبيعي.

Linux

السكربت يستهدف التوزيعات المبنية على glibc افتراضيًا. مُختبَر على Ubuntu وDebian ومشتقّات Arch. على حاوية صغيرة (minimal container) قد تحتاج إلى curl وزمن تشغيل C عامل؛ ثبّتهما عبر مدير حزم نظامك قبل تشغيل السكربت.

Windows (عبر WSL2)

لا يوجد مُثبِّت Windows أصلي اليوم. المسار المدعوم هو WSL2:

ثبّت WSL2 عبر wsl --install من PowerShell (كمسؤول).
اختر توزيعة Linux من متجر Microsoft (Ubuntu مناسبة).
افتح صدفة Linux الجديدة وشغّل أمر curl للتثبيت القياسي من هناك.

ملفات Zero التنفيذية المبنية تحت WSL2 هي ملفات تنفيذية للينكس. تستطيع تشغيلها من داخل WSL2 واستدعاءها من Windows عبر آلية التشغيل البيني (interop) لكن لا يمكنك شحنها كملفات .exe أصلية.

تحديث Zero

أبسط طريقة للترقية هي إعادة تشغيل سكربت التثبيت نفسه. يكتب فوق الملفات التنفيذية الموجودة في ~/.zero/bin. ولأن Zero قبل الإصدار 1.0، توقّع أن تجلب الإصدارات الجديدة تغييرات كاسرة — ثبّت إصدارًا يعمل محليًا إن كنت تشارك قاعدة شيفرة مع آخرين.

إلغاء التثبيت

خطوتان:

rm -rf ~/.zero

ثم احذف سطر export PATH="$HOME/.zero/bin:$PATH" من ملف rc الخاص بصدفتك. التثبيت لم يكتب في أي مكان آخر، لذا هذا يكفي لإزالة Zero بالكامل.

ملاحظة عن الثقة

‏Zero برمجية قبل الإصدار 1.0 من مشروع بحثي تابع لـ Vercel. يوصي الفريق صراحة بتشغيلها في بيئات معزولة — جهاز تطوير معزول، أو حاوية، أو جهاز افتراضي — لا على جهاز عملك الأساسي إن كنت تتعامل مع بيانات حسّاسة. سكربت التثبيت قصير ويستحق القراءة قبل تشغيله، خاصة أن المشروع لا يزال يتغيّر.

التالي: Hello, World

بعد تثبيت سلسلة الأدوات وعمل zero --version، أنت جاهز لترجمة أوّل برنامج لك. Hello, World يشرح كتابة ملف .0 صغير وتشغيله وتفكيكه.

الأسئلة الشائعة

كيف أُثبّت Zero؟

شغّل سكربت التثبيت الرسمي: curl -fsSL https://zerolang.ai/install.sh | bash. يُنزّل المترجم الجاهز إلى ~/.zero/bin/zero. أضف هذا المسار إلى PATH ثم شغّل zero --version للتأكّد من التثبيت.

أين يُثبَّت Zero؟

سكربت التثبيت يضع كل شيء تحت ~/.zero/. الملف التنفيذي zero يعيش في ~/.zero/bin/zero. لا شيء يُثبَّت على مستوى النظام — لا sudo، ولا /usr/local/، ولا حالة لمدير الحزم. لإلغاء التثبيت، تحذف مجلد ~/.zero.

هل تعمل Zero على Windows؟

سكربت التثبيت الرسمي يستهدف macOS وLinux مباشرة. على Windows، المسار الموصى به اليوم هو WSL2 — ثبّت توزيعة Linux من متجر Microsoft، ثم شغّل أمر curl للتثبيت داخل تلك الصدفة. الدعم الأصلي لـ Windows ليس هدفًا موثَّقًا بعد.

كيف أتحقّق من أن Zero مثبَّتة بشكل صحيح؟

شغّل zero --version من طرفية جديدة. إذا طبع نصّ إصدار، فقد نجح التثبيت وتمّ ضبط PATH. إذا حصلت على 'command not found'، فإن الملف التنفيذي ليس على PATH بعد — أعد تشغيل سطر export PATH="$HOME/.zero/bin:$PATH" وأضفه إلى ملف بدء تشغيل صدفتك.

كيف أُلغي تثبيت Zero؟

احذف مجلد التثبيت: rm -rf ~/.zero. ثم احذف سطر export PATH="$HOME/.zero/bin:$PATH" الذي أضفته إلى ~/.zshrc أو ~/.bashrc. لا يوجد أمر إلغاء تثبيت منفصل لأن التثبيت لا يلمس سوى ~/.zero وملف rc الخاص بصدفتك.

مفاهيم ذات صلة