調試 shell 腳本的關鍵方法包括：1. 使用 bash -x 或 set -x 查看執行過程，適用于檢查變量賦值和執行流程；2. 利用 trap 命令捕獲錯誤信息，可顯示錯誤行號和命令；3. 檢查退出狀態碼并記錄日志，幫助識別關鍵步驟失敗；4. 使用 sh -n 和 shellcheck 提前發現語法和潛在問題。掌握這些技巧能有效提升腳本調試效率并快速定位問題根源。
調試 Shell 腳本在 Linux 環境中是一個很常見的需求，尤其是當腳本運行不按預期執行時。掌握一些基本的調試方法和錯誤捕獲技巧，能幫助你快速定位問題所在。
使用 bash -x 或 set -x 查看執行過程
這是最直接的調試方式。通過開啟“追蹤”模式，可以看到腳本每一行實際執行的內容，包括變量替換后的值。
你可以直接在運行腳本時加上 -x 參數：
bash -x your_script.sh
或者，在腳本內部加上：
set -x
這樣就能看到每一步命令的執行情況了。如果你只想查看部分代碼塊的執行，可以配合 set +x 來關閉追蹤：
set -x # 想調試的代碼段 set +x
這種方式特別適合檢查變量是否正確賦值、條件判斷是否成立等問題。
利用 trap 命令捕獲錯誤信息
有時候腳本出錯后就直接退出了，很難知道哪里出了問題。可以用 trap 命令來設置一個“鉤子”，在腳本出錯時輸出更多信息。
比如下面這個例子，會在腳本出錯時打印出錯行號和對應的命令：
trap 'echo "Error on line $LINENO: $BASH_COMMAND"' ERR
將這段代碼加到腳本開頭，就可以在出錯時得到更具體的提示。這對排查邏輯分支中的隱藏問題很有幫助。
如果你想讓腳本在出錯時不立即退出，而是繼續執行后續的清理操作，還可以結合 set -e（遇到錯誤終止）和 trap 一起使用。
檢查退出狀態碼并記錄日志
每個命令執行完都會返回一個退出狀態碼（exit code），0 表示成功，非零表示出錯。你可以通過 $? 來獲取上一條命令的狀態碼。
例如：
some_command if [ $? -ne 0 ]; then echo "some_command failed" fi
這在寫自動化腳本時非常有用。你可以在關鍵步驟后面加上這樣的判斷，及時發現失敗點。
另外，建議把調試信息或錯誤信息記錄到日志文件中，而不是只打印在終端上。比如：
exec > >(tee -a script.log) 2>&1
這樣可以讓腳本的標準輸出和錯誤輸出都保存下來，方便后續分析。
小貼士：使用 sh -n 和 shellcheck 提前發現問題
在運行腳本之前，可以用 sh -n 檢查語法是否有錯誤：
sh -n your_script.sh
它不會執行腳本，只是做語法檢查，適合用于初步驗證腳本是否寫對。
還有一個更好的工具是 shellcheck，它可以檢測出更多潛在的問題，比如未引用的變量、拼寫錯誤等。很多編輯器也支持集成這個工具，提前發現隱患。
基本上就這些常用的方法了。調試 Shell 腳本其實不需要太復雜的工具，關鍵是理解腳本的執行流程和錯誤發生的位置。把這些技巧組合起來，大多數問題都能找到根源。
