Shell 腳本的版本控制最佳實踐

在日常的系統管理與自動化運維工作中，Shell 腳本無疑是最強力的武器之一。然而，許多初學者往往忽略了一個關鍵問題：隨著腳本功能的疊加，代碼變得龐雜且難以維護，最終導致「不敢改、不敢刪」的困境。引入版本控制系統（如 Git）不僅能追蹤歷史變更，更能結合分支策略實現安全的迭代開發。本文將探討如何在 Shell 腳本開發中實踐版本控制的最佳流程，並提供可直接運行的範例。

建立結構化的專案環境

首先，我們需要建立一個清晰的專案目錄結構。建議將腳本與配置檔案分離，並預留 scripts 目錄存放可執行腳本。以下指令將在 Ubuntu 22.04 或 Debian 12 環境中建立基礎結構：

# 建立專案目錄並進入
mkdir -p shell-version-control-demo && cd shell-version-control-demo

# 初始化 Git 倉庫
git init

# 建立 .gitignore 以避免追蹤臨時檔案
cat > .gitignore << EOF
*.log
*.tmp
*.swp
*.pyc
EOF

# 建立腳本目錄
mkdir -p scripts

撰寫第一個可執行的腳本

讓我們撰寫一個簡單的備份腳本 scripts/backup.sh。這個腳本會檢查目錄是否存在，並產生時間戳記的備份檔。請注意，在 Shell 腳本中，良好的註解和變數命名是版本控制的基礎。

#!/bin/bash
# backup.sh - 簡單的檔案備份腳本
# 作者：Linux Tech Blogger
# 版本：1.0

set -euo pipefail

SOURCE_DIR="/tmp/source_data"
BACKUP_DIR="/tmp/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

# 建立必要的目錄
mkdir -p "$SOURCE_DIR" "$BACKUP_DIR"

# 模擬一些測試資料
if [ ! -f "$SOURCE_DIR/test.txt" ]; then
    echo "Hello World" > "$SOURCE_DIR/test.txt"
    echo "Source data created."
fi

# 執行備份
cp -r "$SOURCE_DIR" "$BACKUP_DIR/backup_$TIMESTAMP"

echo "Backup completed successfully at $TIMESTAMP"

賦予執行權限並提交到 Git：

chmod +x scripts/backup.sh
git add .
git commit -m "Initial commit: Add backup script structure"

利用分支進行功能開發

假設我們需要增加一個「壓縮備份」的功能。最佳實踐是不要直接在 main 分支修改，而是建立一個新功能分支：

# 建立並切換到新功能分支
git checkout -b feature/compress-backup

# 修改腳本以支援 gzip 壓縮
cat > scripts/backup.sh << 'EOF'
#!/bin/bash
# backup.sh - 支援壓縮的備份腳本
# 版本：1.1

set -euo pipefail

SOURCE_DIR="/tmp/source_data"
BACKUP_DIR="/tmp/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

mkdir -p "$SOURCE_DIR" "$BACKUP_DIR"

# 模擬測試資料
if [ ! -f "$SOURCE_DIR/test.txt" ]; then
    echo "Hello World" > "$SOURCE_DIR/test.txt"
fi

# 建立壓縮備份檔
tar -czf "$BACKUP_DIR/backup_$TIMESTAMP.tar.gz" -C "$SOURCE_DIR" .

echo "Compressed backup saved to $BACKUP_DIR/backup_$TIMESTAMP.tar.gz"
EOF

chmod +x scripts/backup.sh

# 提交變更
git add scripts/backup.sh
git commit -m "Add gzip compression support to backup script"

合併與衝突處理

當功能開發完成並經過測試後，我們可以切換回主分支進行合併。這一步驟能確保主線代碼的穩定性：

# 切換回主分支
git checkout main

# 合併新功能分支
git merge feature/compress-backup

# 刪除已合併的分支以保持倉庫整潔
git branch -d feature/compress-backup

此時，scripts/backup.sh 已更新為支援壓縮的版本，且所有變更歷史都完整保留在 Git 中。

常見問題與解決方案

1. 腳本中包含敏感資訊（如密碼）怎麼辦？ 絕對不要將密碼硬編碼在腳本中並提交至 Git。應使用環境變數或 .env 檔案（並加入 .gitignore）。在腳本中透過 $(echo $DB_PASSWORD) 讀取，確保敏感資訊不會洩漏。

2. 如何確保腳本在不同環境下的一致性？ Shell 版本差異可能導致語法錯誤。建議在腳本頂部明確指定解釋器版本（如 #!/bin/bash），並在 CI/CD 流程中加入 shellcheck 靜態分析工具，自動檢查潛在的語法錯誤與最佳實踐違規。

小結

透過 Git 對 Shell 腳本進行版本控制，不僅能保護我們的勞動成果，更能透過分支策略降低開發風險。結合 .gitignore 過濾雜訊、明確的 Commit Message 以及功能分支開發流程，能讓你的自動化腳本從「能跑就好」進化為「企業級可靠」的基礎設施代碼。立即開始將你的腳本納入版本控制，享受清晰開發流程帶來的效率提升吧！