PowerShell新建Word文档添加图片页眉失败求助

常见问题及修复方案 #

1. 匹配页眉类型与文档设置 #

你当前代码使用的是wdHeaderFooterFirstPage（首页页眉），但新建Word文档默认未开启“首页不同”，导致首页页眉处于未激活状态，图片虽被添加却无法显示。

修复二选一：

• 开启文档“首页不同”设置：

$section.PageSetup.DifferentFirstPageHeaderFooter = $true

• 改用默认的全页页眉类型wdHeaderFooterPrimary：

$Header = $section.Headers.Item([Microsoft.Office.Interop.Word.wdHeaderFooterIndex]::wdHeaderFooterPrimary)

2. 验证图片路径有效性 #

确保图片绝对路径正确，且当前用户有读取权限。先在PowerShell中验证路径：

Test-Path "C:\BestPracticesSQLServer\output\LPTBR-3H70QW3\image.jpg"

返回True才表示路径有效。

3. 修正代码细节并添加校验 #

统一变量大小写（PowerShell不区分但规范更易维护），同时加入路径校验避免无效操作，完整示例代码：

$script:word = New-Object -ComObject "Word.application" 
$script:word.visible = $true       
$script:doc = $script:word.Documents.Add()  
$section = $script:doc.Sections(1)

# 开启首页不同（若需使用首页页眉）
$section.PageSetup.DifferentFirstPageHeaderFooter = $true

# 获取首页页眉
$Header = $section.Headers.Item([Microsoft.Office.Interop.Word.wdHeaderFooterIndex]::wdHeaderFooterFirstPage)

# 添加图片并校验路径
$imagePath = "C:\BestPracticesSQLServer\output\LPTBR-3H70QW3\image.jpg"
if (Test-Path $imagePath) {
    $Header.Range.InlineShapes.AddPicture($imagePath)
} else {
    Write-Host "图片路径不存在，请检查！"
}

$script:doc.Activate()

4. 手动排查显示异常 #

若代码修改后仍不显示，双击文档页眉区域查看：图片可能因布局设置（如浮于文字下方）或尺寸过大超出页眉范围，可在Word中手动调整图片布局与大小。

内容的提问来源于stack exchange，提问作者Laerte Junior