كيفية تصحيح أخطاء نصوص Linux Bash باستخدام ShellCheck

هل تواجه مشكلة في برنامج Bash النصي الذي كتبته لجهاز الكمبيوتر الذي يعمل بنظام Linux ؟ بدلاً من البحث في عدد لا يحصى من سلاسل الرسائل على StackExchange للمساعدة في البرمجة ، ضع في اعتبارك استخدام أداة ShellCheck لتصحيح أخطاء Linux Bash والعثور تلقائيًا على أخطاء في التعليمات البرمجية الخاصة بك.

احصل على ShellCheck

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

افتح نافذة طرفية وقم بتحديث الحزم الخاصة بك. بعد ذلك ، اتبع التعليمات التي تتوافق مع نظام التشغيل Linux الخاص بك.

أوبونتو

يوجد ShellCheck في مصادر برامج Ubuntu الرسمية ، لذا فإن تثبيته سهل للغاية. في المحطة الطرفية ، استخدم مدير حزمة Apt واحصل على أحدث إصدار من ShellCheck يعمل.

sudo apt تثبيت shellcheck

دبيان

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

ملاحظة: هل تريد إصدارًا أحدث من برنامج ShellCheck؟ اتبع دليلنا وتعرف على كيفية الحصول على المزيد من البرامج الحديثة على دبيان .

sudo apt-get install shellcheck

قوس لينكس

للحصول على ShellCheck على Arch Linux ، ستحتاج أولاً إلى تمكين مستودع برامج "المجتمع". يتطلب تمكين "المجتمع" تحرير ملف Pacman.conf. لتحرير الملف ، افتح Pacman.conf في Nano.

sudo nano /etc/pacman.conf

قم بالتمرير (باستخدام مفاتيح الأسهم) وابحث عن قسم "المجتمع" من الملف. قم بإزالة جميع مثيلات الرمز # (حوالي ثلاثة أسطر). ثم احفظ التعديلات بالضغط على زر Ctrl + O.

مع مراعاة التعديلات الجديدة على Pacman.conf ، اضغط على Ctrl + X لإغلاق Nano. بعد ذلك ، أعد مزامنة Pacman لإعداد الوصول إلى مستودع Arch Linux “Community”.

sudo pacman -Syyuu

أخيرًا ، قم بتثبيت ShellCheck على Arch Linux باستخدام:

sudo pacman -S shellcheck

فيدورا

للحصول على أداة تحليل البرنامج النصي ShellCheck على Fedora Linux ، افتح محطة واستخدم أداة إدارة حزم DNF.

sudo dnf قم بتثبيت ShellCheck

OpenSUSE

لا يتطلب تثبيت ShellCheck على OpenSUSE أي خطوات خاصة ، كما هو الحال في مصادر البرامج الرئيسية للتوزيع. للحصول عليه ، أدخل أمر حزمة Zypper التالي في نافذة طرفية.

sudo zypper تثبيت ShellCheck

لينكس عام

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

الخطوة 1: قم   بتصدير إصدار ShellCheck الذي توشك على تنزيله إلى بيئة المحطة الطرفية.

تصدير scversion = " مستقر "  # أو "v0.4.7" ، أو "أحدث"

الخطوة 2: باستخدام أداة تنزيل wget ، احصل على أحدث إصدار ثنائي من ShellCheck.

wget " https://storage.googleapis.com/shellcheck/shellcheck- $ {scversion} .linux.x86_64.tar.xz "

الخطوة 3: استخرج أرشيف ShellCheck TarXZ باستخدام  الأمر tar  .

tar --xz -xvf shellcheck- " $ {scversion} " .linux.x86_64.tar.xz

الخطوة 4: قم بتثبيت ShellCheck على جهاز كمبيوتر يعمل بنظام Linux باستخدام الأمر cp .

cp shellcheck- " $ {scversion} " / shellcheck / usr / bin /

تصحيح البرامج النصية باستخدام ShellCheck

الغرض الأساسي من ShellCheck هو فحص البرنامج النصي (عادةً Bash) ، واكتشاف الأوامر التي يساء استخدامها وتقديم التصحيحات. للاستخدام الأساسي ، قم بما يلي.

أولاً ، القرص المضغوط إلى حيث يوجد البرنامج النصي الذي ترغب في التحقق منه على جهاز كمبيوتر يعمل بنظام Linux. في هذا البرنامج التعليمي ، يوجد البرنامج النصي الخاص بنا في ~ / shell-scripts . قد تختلف لك.

cd ~ / shell-scripts

قم بتشغيل الأمر ls واعرض جميع الملفات في الدليل الحالي.

ملاحظة: إذا كنت تنوي استخدام ShellCheck في دليل مع أنواع ملفات متعددة ، فمن الجيد الجمع بين  grep  و  ls  معًا. يتيح لك استخدام هذين الأمرين معًا تصفية جميع الملفات غير النصية.

ls

أو قم بدمجه مع grep لعرض ملفات البرامج النصية فقط.

ls | grep ".sh"
ls | grep ".bash"

ابحث عن اسم ملف البرنامج النصي في موجه ls وقم بتمييز اسم الملف بالماوس. عندما تكون جاهزًا ، قم بتشغيله من خلال ShellCheck وتحقق من التعليمات البرمجية الخاصة بك.

shellcheck name- of-file.sh

أو

shellcheck اسم الملف

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

احفظ تقرير ShellCheck في ملف

يعد الحصول على تقرير فوري في المحطة الطرفية لبرمجة bash مفيدًا للغاية ، ومع ذلك ، فقد تفقده إذا أغلقت الجهاز. للتغلب على فقدان تقرير shellcheck الخاص بك ، نوصي بحفظ الإخراج في ملف نصي ، عن طريق تشغيل البرنامج مع ميزة >> في الجهاز.

shellcheck name-of-file.sh >> ~ / Documents / shellcheck-report-name-of-file.sh

أو

shellcheck name-of-file.bash >> ~ / Documents / shellcheck-report-name-of-file.bash

اعرض تقريرك المحفوظ في المحطة عبر أمر cat .

cat ~ / Documents / shellcheck-report-name-of-file.sh | أكثر

أو

cat ~ / Documents / shellcheck-report-name-of-file.bash | أكثر