الفحص باستخدام ShellCheck

ShellCheck

مفهوم ~16 دقيقة

الفحص باستخدام ShellCheck — ShellCheck

تثبيت ShellCheck

# macOS (Homebrew)
brew install shellcheck

# Ubuntu / Debian
sudo apt install shellcheck

# Fedora / RHEL
sudo dnf install ShellCheck

# أو مباشرة بدون مدير حزم
scversion="stable"
wget -qO- "https://github.com/koalaman/shellcheck/releases/download/${scversion}/shellcheck-${scversion}.linux.x86_64.tar.xz" | tar -xJv

بعد التثبيت: shellcheck --version يعرض الإصدار. يمكن أيضاً استخدام النسخة الأونلاين على shellcheck.net.

ShellCheck أداة فحص ساكن لسكربتات shell. تقرأ الكود وتنبّهك إلى أخطاء شائعة مثل متغير غير مقتبس، استخدام ls داخل for, أو توسعات قد تتصرف بشكل مفاجئ. هي لا تثبت أن السكربت صحيح، لكنها تلتقط طبقة مهمة من الأخطاء قبل التشغيل.

في مشروع حقيقي، شغّل shellcheck script.sh كجزء من المراجعة. إذا أعطتك الأداة تحذيراً، لا تسكته فوراً. اقرأ السبب. أحياناً يكون التحذير هو بالضبط الخطأ الذي كنت ستكتشفه بعد ضرر. إذا احتجت تجاهل تحذير، اكتب سبباً واضحاً.

مثال على عادة جيدة

script.sh

#!/usr/bin/env bash
set -euo pipefail

# اكتب كوداً سهل الفحص — Write lint-friendly code
files=("README.md" "notes file.txt")

for file in "${files[@]}"; do
	echo "file=$file"
done

Output:

الأداة ستحب الاقتباس الواضح وarrays الصحيحة. هذا لا يعني أن الكود مثالي، لكنه يقلل الأخطاء الميكانيكية.

ShellCheck ليس بديلاً عن الاختبار

الفحص الساكن لا يعرف دائماً هل منطقك التجاري صحيح. قد يمر سكربت من ShellCheck لكنه ينسخ الملف الخطأ. لذلك اجمع بين الفحص والاختبارات الصغيرة وdry-run.

تحدي — Challenge

#!/usr/bin/env bash
set -euo pipefail

word="quoted"

# اطبع المتغير باقتباس — Print the quoted variable