使用Module Builder打包带外部DLL的PowerShell模块遇加载问题求助

1. 标准化模块目录结构 #

统一目录结构是解决路径问题的基础，推荐采用：

MyModule/
├── MyModule.psd1
├── MyModule.psm1
├── lib/
│   ├── MahApps.Metro.dll
│   └── Ookii.Dialogs.Winforms.dll

2. 修正模块清单配置 #

在MyModule.psd1中，RequiredAssemblies字段必须填写相对模块根目录的完整路径，而非仅文件名，让PowerShell能直接定位lib目录下的依赖：

@{
    RootModule           = 'MyModule.psm1'
    RequiredAssemblies   = @('lib/MahApps.Metro.dll', 'lib/Ookii.Dialogs.Winforms.dll')
    # 其他清单字段（版本、作者等）...
    PrivateData = @{
        PSData = @{
            # 其他PSData配置（发布信息等）...
        }
    }
}

3. 优化Module Builder构建脚本 #

确保构建时完整复制lib目录到输出路径，无需手动移动DLL到模块根目录：

# 定义路径变量
$scriptRoot = $PSScriptRoot
$outputModulePath = Join-Path $scriptRoot 'output/MyModule'
$sourceLibPath = Join-Path $scriptRoot 'lib'
$destLibPath = Join-Path $outputModulePath 'lib'

# 创建目标lib目录（如果不存在）
if (-not (Test-Path $destLibPath)) {
    New-Item -ItemType Directory -Path $destLibPath | Out-Null
}

# 复制所有DLL到输出目录的lib文件夹
Copy-Item -Path (Join-Path $sourceLibPath '*.dll') -Destination $destLibPath -Force

4. 添加程序集加载检查逻辑 #

在模块入口文件MyModule.psm1开头加入加载检查，自动适配开发/生产环境路径，避免重复加载：

# 获取模块根目录，自动适配不同环境
$moduleRoot = $PSScriptRoot
$libDir = Join-Path $moduleRoot 'lib'

# 定义需要加载的依赖程序集
$assembliesToLoad = @(
    Join-Path $libDir 'MahApps.Metro.dll'
    Join-Path $libDir 'Ookii.Dialogs.Winforms.dll'
)

foreach ($asmPath in $assembliesToLoad) {
    # 检查文件是否存在
    if (-not (Test-Path $asmPath)) {
        throw "缺失依赖程序集：$asmPath"
    }

    # 检查程序集是否已加载
    $asmName = [System.Reflection.AssemblyName]::GetAssemblyName($asmPath)
    $loadedAsm = [System.AppDomain]::CurrentDomain.GetAssemblies() | 
        Where-Object { $_.FullName -eq $asmName.FullName }

    if (-not $loadedAsm) {
        try {
            [System.Reflection.Assembly]::LoadFrom($asmPath) | Out-Null
            Write-Verbose "成功加载程序集：$asmPath"
        }
        catch {
            throw "加载程序集失败：$asmPath`n错误详情：$_"
        }
    }
}

5. 消除开发时路径警告 #

如果VS Code或PowerShell编辑器提示找不到./lib下的DLL，可通过配置让编辑器识别依赖路径：

• 在模块目录创建.vscode/settings.json：

{
    "powershell.scriptAnalysis.settingsPath": "./analyzersettings.json"
}

• 再创建analyzersettings.json指定依赖路径：

{
    "dependencies": {
        "paths": ["./lib"]
    }
}

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