shellcheck - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

shellcheck - Công cụ phân tích tập lệnh Shell

SYNOPSIS

vỏ sò [LỰA CHỌN...] CÁC TẬP TIN...

MÔ TẢ

ShellCheck là một công cụ phân tích tĩnh và in linting cho các tập lệnh sh / bash. Nó chủ yếu tập trung
về cách xử lý các lỗi cú pháp cho người mới bắt đầu và mức độ trung bình điển hình và các cạm bẫy trong đó
shell chỉ đưa ra một thông báo lỗi khó hiểu hoặc hành vi lạ, nhưng nó cũng báo cáo về một số
các vấn đề nâng cao hơn trong đó các trường hợp góc có thể gây ra lỗi chậm trễ.

ShellCheck đưa ra lời khuyên cụ thể về shell. Hãy xem xét dòng:

((diện tích = 3.14 * r * r))

· Đối với các tập lệnh bắt đầu bằng #!/ Bin / sh (hoặc khi sử dụng -s sh), ShellCheck sẽ cảnh báo rằng
((..)) không tuân thủ POSIX (tương tự như bảng kiểm tra).

· Đối với các tập lệnh bắt đầu bằng #!/ bin / bash (hoặc sử dụng -s bash), ShellCheck sẽ cảnh báo rằng
số thập phân không được hỗ trợ.

· Đối với các tập lệnh bắt đầu bằng #! / Bin / ksh (hoặc sử dụng -s ksh), ShellCheck sẽ không cảnh báo gì cả,
vì ksh hỗ trợ số thập phân trong ngữ cảnh số học.

LỰA CHỌN

-e CODE1[,CODE2...], --exclude =CODE1[,CODE2...]
Loại trừ rõ ràng các mã đã chỉ định khỏi báo cáo. Tiếp theo -e lựa chọn là
tích lũy, nhưng tất cả các mã có thể được chỉ định cùng một lúc, được phân tách bằng dấu phẩy thành một mã duy nhất
tranh luận.

-f FORMAT, --format =FORMAT
Chỉ định định dạng đầu ra của shellcheck, in kết quả của nó theo tiêu chuẩn
đầu ra. Tiếp theo -f các tùy chọn bị bỏ qua, hãy xem M FORU ĐƠN dưới đây để biết thêm thông tin.

-s shell, --shell =shell
Chỉ định phương ngữ vỏ Bourne. Giá trị hợp lệ là sh, bash và ksh. Mặc định là
để sử dụng shebang của tệp, hoặc bash nếu vỏ mục tiêu không thể được xác định.

-V phiên bản, --phiên bản
Phiên bản in và thoát.

M FORU ĐƠN

tty Văn bản thuần túy, đầu ra con người có thể đọc được. Đây là mặc định.

gcc Đầu ra tương thích GCC. Hữu ích cho các biên tập viên hỗ trợ biên dịch và hiển thị
lỗi cú pháp.

Ví dụ: trong Vim,: set makeprg = shellcheck \ -f \ gcc \% sẽ cho phép sử dụng: make to
kiểm tra tập lệnh và: cnext để chuyển đến lỗi tiếp theo.

: : : :

kiểu kiểm tra
Đầu ra XML tương thích kiểu kiểm tra. Được hỗ trợ trực tiếp hoặc thông qua các plugin bởi nhiều
IDE và xây dựng hệ thống giám sát.




<lỗi
line = 'line'
column = 'column'
Mức độ nghiêm trọng = 'mức độ nghiêm trọng'
message = 'tin nhắn'
source = 'ShellCheck.SC ####' />
...

...


json Json là một định dạng tuần tự hóa phổ biến phù hợp hơn cho các ứng dụng web.
ShellCheck's json nhỏ gọn và chỉ chứa mức tối thiểu.

[
{
"tệp": "tên tệp",
"line": lineNumber,
"column": columnNumber,
"level": "mức độ nghiêm trọng",
"mã": errorCode,
"message": "thông báo cảnh báo"
},
...
]

HƯỚNG DẪN

Các chỉ thị ShellCheck có thể được chỉ định dưới dạng các chú thích trong tập lệnh shell trước một lệnh hoặc
khối:

# shellcheck key = value key = value
lệnh hoặc cấu trúc

Ví dụ: để ngăn chặn SC2035 bằng cách sử dụng ./*.jpg:

# shellcheck vô hiệu hóa = SC2035
echo "Tệp:" * .jpg

Ở đây, một nhóm dấu ngoặc nhọn được sử dụng để ngăn chặn trên nhiều dòng:

# shellcheck vô hiệu hóa = SC2016
{
echo 'Đang sửa đổi $ PATH'
echo 'PATH = foo: $ PATH' >> ~ / .bashrc
}

Các khóa hợp lệ là:

vô hiệu hóa
Tắt danh sách mã lỗi được phân tách bằng dấu phẩy cho lệnh sau. Các
lệnh có thể là một lệnh đơn giản như echo foo hoặc một lệnh ghép như
định nghĩa hàm, khối hoặc vòng lặp vỏ con.

Sử dụng shellcheck trực tuyến bằng các dịch vụ onworks.net