如何在模块ScriptsToProcess初始化脚本未加载模块时引用本地化字符串？

核心思路 #

初始化脚本运行时，虽然.psm1尚未加载，但模块对象已可用，因此可以通过模块对象定位到本地化文件路径，同时复刻.psm1中的本地化加载逻辑——优先加载对应语言的本地化数据，失败则使用默认字符串。

具体实现方案 #

方案1：在初始化脚本中内置默认字符串（与.psm1保持一致） #

适合不想额外增加文件的场景，直接将.psm1开头data段的默认字符串复制到初始化脚本中，再实现本地化加载逻辑：

# 1. 获取模块根目录（确保能定位到本地化文件）
$moduleRoot = $MyInvocation.MyCommand.Module.ModuleBase

# 2. 定义默认本地化字符串（与.psm1中data段内容完全一致）
$defaultLocalizedData = @{
    PrerequisiteFailed = "未满足先决条件，无法加载模块。"
    # 补充其他需要的默认本地化字段
}

# 3. 尝试加载对应语言的本地化数据
try {
    $localizedData = @{}
    # Import-LocalizedData会自动查找模块根目录下对应langId文件夹中的ModuleResources.psd1
    Import-LocalizedData -BindingVariable localizedData -BaseDirectory $moduleRoot -FileName ModuleResources.psd1
}
catch {
    # 加载失败时使用默认字符串
    $localizedData = $defaultLocalizedData
}

# 4. 执行先决条件检查并抛出本地化异常
if (-not (Test-Prerequisite)) { # 替换为你的实际检查逻辑
    throw $localizedData.PrerequisiteFailed
}

方案2：提取默认字符串到共享文件（避免重复维护） #

如果希望默认字符串只维护一份，可以将其单独放在模块根目录的ModuleResources.Default.psd1文件中，让初始化脚本和.psm1都加载这个文件：

步骤1：创建共享默认数据文件 ModuleResources.Default.psd1

@{
    PrerequisiteFailed = "未满足先决条件，无法加载模块。"
    # 其他默认本地化字段
}

步骤2：初始化脚本中的实现

$moduleRoot = $MyInvocation.MyCommand.Module.ModuleBase

# 加载共享的默认本地化数据
$defaultDataPath = Join-Path -Path $moduleRoot -ChildPath "ModuleResources.Default.psd1"
$defaultLocalizedData = Import-PowerShellDataFile -Path $defaultDataPath

# 尝试加载对应语言的本地化数据
try {
    $localizedData = @{}
    Import-LocalizedData -BindingVariable localizedData -BaseDirectory $moduleRoot -FileName ModuleResources.psd1
}
catch {
    $localizedData = $defaultLocalizedData
}

# 执行先决条件检查
if (-not (Test-Prerequisite)) {
    throw $localizedData.PrerequisiteFailed
}

步骤3：同步修改.psm1中的加载逻辑

$moduleRoot = $PSScriptRoot

# 加载共享的默认本地化数据
$defaultDataPath = Join-Path -Path $moduleRoot -ChildPath "ModuleResources.Default.psd1"
$defaultLocalizedData = Import-PowerShellDataFile -Path $defaultDataPath

try {
    Import-LocalizedData -BindingVariable localizedData -BaseDirectory $moduleRoot -FileName ModuleResources.psd1
}
catch {
    $localizedData = $defaultLocalizedData
}

# .psm1的其他逻辑...

关键说明 #

• $MyInvocation.MyCommand.Module.ModuleBase：可以可靠获取模块的根目录，无论初始化脚本在模块中的位置如何。
• Import-LocalizedData：会自动根据当前系统的语言设置，查找模块根目录下对应langId（如zh-CN）文件夹中的ModuleResources.psd1文件，逻辑与.psm1中的保持一致。
• 异常处理：当对应语言的本地化文件不存在时，会捕获异常并切换到默认字符串，确保模块的容错性。

内容的提问来源于stack exchange，提问作者Paul π