PowerShell 腳本輸出與原始碼保存技巧

PowerShell 多行字串與腳本輸出最佳實踐

在 PowerShell 腳本開發中，經常需要將動態生成的腳本內容輸出到檔案，或在 ISE/VS Code 中編輯時保持語法高亮。本文介紹使用「大括號語法」替代傳統 Here-String 的技巧，解決變數展開控制、編輯器高亮、原始碼保真度等痛點。

傳統 Here-String 痛點

$code = @"
Invoke-WebRequest 'https://example.com'
Get-Service -Name AdobeARMservice
$name = 'Mosser Lee'
"@

• 變數 $name 會被自動展開，若需保留原樣需用單引號包裹整個字串，但內部若有單引號則需大量跳脫
• 字串內容在 ISE/VS Code 中無語法高亮，難以除錯
• 多層巢狀引號處理極其繁瑣

大括號語法優勢

{
    Invoke-WebRequest 'https://www.jb51.net'
    Get-Service -Name AdobeARMservice
    $name = 'Mosser Lee'
} | Out-File 'my.ps1'

核心優點

1. 完整語法高亮：ISE/VS Code 將大括號內視為獨立腳本區塊，提供完整語法著色、智能縮排、錯誤標記
2. 原始碼保真輸出：管線輸出到檔案時，保留原始格式、變數引用、註解、縮排，無任何展開或轉義
3. 變數作用域隔離：大括號建立新的子作用域，內部變數不會汙染外部
4. 零跳脫字元：單雙引號混用無需跳脫，極大簡化字串處理

進階應用模式

1. 參數化腳本生成

param(
    [string]$Url = 'https://default.com',
    [string]$ServiceName = 'wuauserv'
)

$generatedScript = {
    param($TargetUrl, $SvcName)
    Invoke-WebRequest -Uri $TargetUrl -OutFile 'response.html'
    Restart-Service -Name $SvcName -Force
}

# 將參數化腳本存檔
$generatedScript | Out-File 'deploy.ps1' -Encoding UTF8

# 執行時傳入參數
& '.\deploy.ps1' -TargetUrl $Url -SvcName $ServiceName

2. 動態建構腳本區塊

$scriptBlock = [ScriptBlock]::Create(@"
Write-Host "動態生成時間: $(Get-Date)"
$env:COMPUTERNAME
"@)

# 立即執行
& $scriptBlock

# 或存檔
$scriptBlock.ToString() | Out-File 'dynamic.ps1'

3. 模組化腳本組合

function Get-CommonHeader {
    return {
        #Requires -Version 5.1
        Set-StrictMode -Version Latest
        $ErrorActionPreference = 'Stop'
    }
}

function Get-MainLogic {
    return {
        Write-Host "執行主要邏輯..."
        Get-Process | Sort-Object CPU -Descending | Select-Object -First 5
    }
}

# 組合生成完整腳本
$fullScript = {
    $(Get-CommonHeader)
    $(Get-MainLogic)
    Write-Host "完成"
}

$fullScript | Out-File 'modular.ps1'

常見場景對比

注意事項

• 大括號語法建立的是 ScriptBlock 物件，管線輸出時會呼叫 ToString()
• 若需在大括號內強制展開外部變數，使用 $($var) 語法
• Out-File 預設編碼為 UTF-16LE (Windows PowerShell) 或 UTF-8 (PowerShell 7+)，建議顯式指定 -Encoding UTF8
• 大括號內的 return/break/continue 只影響 ScriptBlock 內部流程