Cách gỡ lỗi tập lệnh Linux Bash với ShellCheck

Bạn có gặp sự cố với tập lệnh Bash mà bạn đã viết cho PC Linux của mình không? Thay vì xem qua vô số chuỗi trên StackExchange để được trợ giúp lập trình, hãy cân nhắc sử dụng công cụ ShellCheck để gỡ lỗi các tập lệnh Linux Bash và tự động tìm lỗi trong mã của bạn.

Nhận ShellCheck

ShellCheck là một công cụ hữu ích, nhưng nó không đi kèm với hệ điều hành Linux của bạn. Thay vào đó, nếu bạn muốn sử dụng nó, bạn sẽ phải cài đặt nó trước. Trong hướng dẫn này, chúng tôi sẽ trình bày cách cài đặt ShellCheck từ các nguồn phần mềm chính thức khác nhau. Ngoài ra, chúng tôi cũng sẽ chỉ cho bạn cách làm cho chương trình hoạt động thông qua hệ nhị phân Linux chung.

Mở cửa sổ đầu cuối và cập nhật các gói của bạn. Sau đó, hãy làm theo các hướng dẫn tương ứng với hệ điều hành Linux của bạn.

Ubuntu

ShellCheck nằm trong nguồn phần mềm chính thức của Ubuntu nên việc cài đặt nó khá dễ dàng. Trong một thiết bị đầu cuối, hãy sử dụng trình quản lý gói Apt và làm cho phiên bản ShellCheck mới nhất hoạt động.

sudo apt cài đặt shellcheck

Debian

Debian Stable đã có sẵn phiên bản ShellCheck cũ hơn để người dùng cài đặt. Hãy nhớ rằng phiên bản này được giữ lại do cách Debian thực hiện mọi thứ.

Lưu ý: muốn có phiên bản mới hơn của chương trình ShellCheck? Làm theo hướng dẫn của chúng tôi và tìm hiểu về cách tải phần mềm hiện đại hơn trên Debian .

sudo apt-get install shellcheck

Arch Linux

Để tải ShellCheck trên Arch Linux, trước tiên bạn cần kích hoạt kho phần mềm “Cộng đồng”. Bật “Cộng đồng” yêu cầu chỉnh sửa tệp Pacman.conf. Để chỉnh sửa tệp, hãy mở Pacman.conf trong Nano.

sudo nano /etc/pacman.conf

Cuộn qua (bằng các phím mũi tên) và tìm phần “Cộng đồng” của tệp. Xóa tất cả các trường hợp của ký hiệu # (khoảng ba dòng). Sau đó, lưu các chỉnh sửa bằng cách nhấn tổ hợp phím Ctrl + O nút.

Với các chỉnh sửa mới đối với Pacman.conf, hãy nhấn Ctrl + X để đóng Nano. Sau đó, đồng bộ hóa lại Pacman để thiết lập quyền truy cập vào kho lưu trữ “Cộng đồng” Arch Linux.

sudo pacman -Syyuu

Cuối cùng, cài đặt ShellCheck vào Arch Linux với:

sudo pacman -S shellcheck

Fedora

Để có được công cụ phân tích tập lệnh ShellCheck trên Fedora Linux, hãy mở một thiết bị đầu cuối và sử dụng công cụ quản lý gói DNF.

sudo dnf cài đặt ShellCheck

OpenSUSE

Cài đặt ShellCheck trên OpenSUSE không yêu cầu các bước đặc biệt, vì nó nằm trong nguồn phần mềm chính của bản phân phối. Để có được nó, hãy nhập lệnh gói Zypper sau trong cửa sổ dòng lệnh.

sudo zypper cài đặt ShellCheck

Linux chung

Người dùng của các bản phân phối Linux ít được biết đến hơn muốn truy cập vào công cụ phân tích tập lệnh ShellCheck phải cài đặt bản phát hành nhị phân phổ quát. May mắn thay, bản phát hành nhị phân này rất dễ cài đặt và không yêu cầu sửa đổi mã nguồn. Để làm cho nó hoạt động, hãy làm theo các bước dưới đây!

Bước 1:   Xuất phiên bản ShellCheck bạn sắp tải xuống môi trường đầu cuối.

export scversion = " ổn định "  # hoặc "v0.4.7" hoặc "mới nhất"

Bước 2: Sử dụng công cụ tải xuống wget , lấy bản phát hành nhị phân ShellCheck mới nhất.

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

Bước 3: Giải nén kho lưu trữ ShellCheck TarXZ bằng  lệnh tar  .

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

Bước 4: Cài đặt ShellCheck vào PC Linux của bạn bằng lệnh cp .

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

Gỡ lỗi tập lệnh với ShellCheck

Mục đích chính của ShellCheck là xem qua một tập lệnh (thường là Bash), phát hiện các lệnh bị lạm dụng và đưa ra các sửa chữa. Để sử dụng cơ bản, hãy làm như sau.

Đầu tiên, hãy chuyển CD đến nơi tập lệnh bạn muốn kiểm tra trên PC Linux của mình. Trong hướng dẫn này, tập lệnh của chúng tôi nằm trong ~ / shell-scripts . Của bạn có thể khác nhau.

cd ~ / shell-scripts

Chạy lệnh ls và xem tất cả các tệp trong thư mục hiện tại.

Lưu ý: nếu bạn định sử dụng ShellCheck trong một thư mục có nhiều loại tệp, bạn nên kết hợp  grep  và  ls  với nhau. Sử dụng hai lệnh này cùng nhau cho phép bạn lọc ra tất cả các tệp không phải tập lệnh.

ls

Hoặc, kết hợp với grep để chỉ xem các tệp tập lệnh.

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

Tìm tên của tệp script trong dấu nhắc ls và đánh dấu tên tệp bằng chuột. Khi đã sẵn sàng, hãy chạy nó qua ShellCheck và kiểm tra mã của bạn.

shellcheck name-of-file.sh

hoặc là

shellcheck name-of-file.bash

Ngay sau khi lệnh shellcheck chạy, nó sẽ phát hiện các vấn đề với mã của bạn và đưa nó vào dấu nhắc đầu cuối. Đọc qua và tìm hiểu cách cải thiện chương trình của bạn bằng cách làm theo các đề xuất mà nó cung cấp cho bạn.

Lưu báo cáo ShellCheck vào một tệp

Nhận một báo cáo tức thì trong thiết bị đầu cuối để lập trình bash của bạn là cực kỳ hữu ích, tuy nhiên, bạn có thể mất nó nếu bạn đóng thiết bị đầu cuối. Để tránh mất báo cáo shellcheck của bạn, chúng tôi khuyên bạn nên lưu kết quả đầu ra vào tệp văn bản, bằng cách chạy chương trình kết hợp với tính năng >> trong terminal.

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

hoặc là

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

Xem báo cáo đã lưu của bạn trong thiết bị đầu cuối thông qua lệnh mèo .

cat ~ / Documents / shellcheck-report-name-of-file.sh | hơn

hoặc là

cat ~ / Documents / shellcheck-report-name-of-file.bash | hơn