核心差異:子 Shell vs 當前 Shell
| 方式 | 語法 | 執行環境 | 變數/函數共享 | 適用場景 |
| source | source ./lib.sh | 當前 Shell 進程 | ✅ 完全共享 | 載入配置、函數庫、環境變數 |
| 點命令 | . ./lib.sh | 當前 Shell 進程 | ✅ 完全共享 | POSIX 標準,移植性更好 |
| 直接執行 | ./lib.sh 或 bash ./lib.sh | 新建子 Shell | ❌ 隔離 (子 Shell 修改不影響父級) | 獨立腳本、需隔離環境 |
語法細節與陷阱
# ✅ 正確:點與路徑之間有空格
. ./common.sh
source ./common.sh
# ❌ 錯誤:無空格視為相對路徑檔案名
../common.sh # 這是指上層目錄的 common.sh!
# ✅ 絕對路徑 (推薦生產環境)
source /opt/myapp/lib/common.sh
. /opt/myapp/lib/common.sh
# ✅ 相對路徑 (需確保工作目錄正確)
source ../lib/common.sh
實戰範例:共用函數庫模式
lib.sh (被調用腳本)
#!/usr/bin/env bash
# lib.sh - 共用函數庫,不需執行權限
# 環境變數
export APP_NAME="MyApp"
export LOG_LEVEL="INFO"
# 共用函數
log_info() {
echo "[INFO] $(date '+%F %T') $*"
}
log_error() {
echo "[ERROR] $(date '+%F %T') $*" >&2
}
# 陣列函數 (需 Bash 4.0+)
join_by() {
local IFS="$1"; shift
echo "$*"
}
main.sh (主腳本)
#!/usr/bin/env bash
# main.sh - 主程式,需執行權限 chmod +x main.sh
# 載入共用庫 (推薦用點命令,POSIX 相容)
. "$(dirname "${BASH_SOURCE[0]}")/lib.sh"
# 現在可以直接使用 lib.sh 定義的變數與函數
log_info "啟動 $APP_NAME (日誌等級: $LOG_LEVEL)"
# 使用陣列函數
fruits=("蘋果" "香蕉" "橘子")
log_info "水果清單: $(join_by ", " "${fruits[@]}")"
# 修改變數會影響後續 source 的腳本 (同一 Shell 進程)
LOG_LEVEL="DEBUG"
log_info "調整日誌等級為 DEBUG"
進階技巧
1. 防止重複載入
# lib.sh 頂部加入
[[ "${_LIB_SH_LOADED:-}" == "1" ]] && return 0
_LIB_SH_LOADED=1
2. 僅匯出特定函數 (Bash)
# lib.sh
export -f log_info log_error # 讓子 Shell 也能用 (若需 export 給子進程)
# 或使用命名空間前綴
myapp_log_info() { ... }
3. 參數傳遞給被載入腳本
# source 不支援直接傳參,改用全域變數
CONFIG_FILE="/etc/myapp.conf"
. ./config_loader.sh # 內部讀取 $CONFIG_FILE
常見錯誤排查
- 「command not found」:路徑錯誤,用
$(dirname "$0") 取得腳本目錄
- 變數未生效:確認用
source 或 . 而非直接執行
- 語法錯誤:被載入腳本語法錯誤會導致主腳本終止,建議先獨立測試
bash -n lib.sh
- set -e 陷阱:被載入腳本
set -e 導致主腳本意外退出,載入前暫存 set +e
最佳實踐總結
- 共用庫用
. ./lib.sh (POSIX) 或 source ./lib.sh (Bash 增強可讀性)
- 庫檔案不需執行權限;主腳本需執行權限
- 使用
$(dirname "${BASH_SOURCE[0]}") 定位庫路徑,避免工作目錄變更導致失效
- 庫檔案頂部加入重複載入保護
- 盡量避免在庫中修改全域狀態,改用函數參數/返回值