PowerShell中Invoke-WebRequest追加内容到文件及脚本优化方法

核心需求实现：追加写入请求内容 #

Invoke-WebRequest的-OutFile参数仅支持覆盖写入，要实现追加，只需调整为「先获取响应内容，再通过支持追加的cmdlet写入文件」的逻辑，配合PowerShell原生的Add-Content即可实现，同时要注意编码适配避免.gitignore文件乱码。

可直接运行的修改后代码 #

# 预定义配置项
$gitignoreTemplates = @('Global/JetBrains','Global/Vim','Global/VisualStudioCode','Global/macOS','Python','Terraform')
$targetGitignorePath = "$Env:USERPROFILE/.gitignore"
$githubRawPrefix = "https://raw.githubusercontent.com/github/gitignore/master"

# 循环拉取并追加内容
foreach ($template in $gitignoreTemplates) {
    $response = Invoke-WebRequest -UseBasicParsing -Uri "$githubRawPrefix/$template.gitignore"
    $response.Content | Add-Content -Path $targetGitignorePath -Encoding UTF8
}

脚本简洁易读优化技巧 #

• 拆分配置与逻辑：把模板列表、目标路径、公共前缀等固定配置单独抽为变量，后续修改配置不需要调整逻辑代码，可读性更强
• 替换反引号换行：PowerShell中管道符、大括号、foreach等关键字后的换行不需要加反引号转义，删除冗余的反引号可以大幅降低语法出错概率
• 用参数飞溅（Splatting）复用公共参数：如果公共参数较多，可以存为哈希表复用，简化重复代码：

# 定义Invoke-WebRequest公共参数
$commonIwrParams = @{
    UseBasicParsing = $true
    # 后续如果要加超时、代理等参数，统一在这里修改即可
}

# 调用时直接传入哈希表
$response = Invoke-WebRequest @commonIwrParams -Uri "$githubRawPrefix/$template.gitignore"

• 批量写入优化：如果模板数量较多，可以先把所有响应内容收集到内存中，最后一次性写入文件，减少频繁磁盘IO：

# 批量拉取所有内容
$allTemplateContent = foreach ($template in $gitignoreTemplates) {
    (Invoke-WebRequest @commonIwrParams -Uri "$githubRawPrefix/$template.gitignore").Content
}
# 一次性写入
$allTemplateContent | Add-Content -Path $targetGitignorePath -Encoding UTF8

注意事项 #

PowerShell 5.1 中Add-Content默认使用系统ANSI编码，必须显式指定-Encoding UTF8才能保证.gitignore文件在不同环境下正常识别，不会出现乱码。

内容的提问来源于stack exchange，提问作者Intrastellar Explorer