PowerShell模块文件.psd1必须用PowerShell运行时解析，不可用C#直接读取；正确方式是引用Microsoft.PowerShell.SDK，调用Import-PowerShellDataFile并取BaseObject获取Hashtable，且需绝对路径、及时Dispose。
PowerShell模块文件不是C#原生格式，别试图用File.ReadAllText直接解析.psd1
PSD1是PowerShell的哈希表序列化格式，本质是PowerShell代码（尽管看起来像JSON），C#没有内置解析器。直接读取再正则或JsonConvert.DeserializeObject会失败——ConvertFrom-StringData不适用，ConvertFrom-Json也报错，因为PSD1支持嵌套哈希、脚本块、类型标注（如[datetime]::Now）等非JSON语法。
正确路径只有一条：调用PowerShell运行时解析。别绕开它，也别写“轻量级PSD1解析器”，那只会漏掉@{Key='Value'; Nested=@{A=1}}或Root = @{ PSModuleVersion = '1.2.3' }这类合法结构。
- 必须引用
System.Management.AutomationNuGet 包（v7+ 推荐用Microsoft.PowerShell.SDK） - 初始化 runspace 前先调用
[Powershell].Assembly.GetTypes()触发自动加载，否则首次PowerShell.Create()可能卡住 - PSD1 文件路径需用绝对路径传入，相对路径在 runspace 中默认以 PowerShell 工作目录为准，和 C# 当前目录无关
用PowerShell.Create().AddScript()安全加载.psd1并提取哈希表
不能用 Import-Module 或 Invoke-Expression 加载 PSD1——它不是模块，是配置数据。正确做法是用 Import-PowerShellDataFile（v5.1+）或手动 Invoke-Expression + ConvertFrom-StringData 回退（不推荐）。v5.1 后应强制走 Import-PowerShellDataFile。
Powershell ps = PowerShell.Create();
ps.AddScript("Import-PowerShellDataFile -Path 'C:\mod\MyModule.psd1'");
var result = ps.Invoke();
if (ps.HadErrors) {
throw new InvalidOperationException(string.Join("; ", ps.Streams.Error.Select(e => e.Exception.Message)));
}
Hashtable data = result[0].BaseObject as Hashtable; // 注意是 BaseObject，不是 ToString()
-
Import-PowerShellDataFile会做安全检查，拒绝含命令、函数定义的 PSD1；若遇到被拒文件，说明它其实不是纯数据文件，而是伪装成 PSD1 的脚本 - 返回对象是
PSObject，必须取.BaseObject才能得到原始Hashtable，否则得到的是带属性包装的代理对象 - PowerShell runspace 是有状态的，每次用完建议调用
ps.Dispose()，尤其在循环中反复加载多个 PSD1 时，否则内存泄漏明显
.psm1 是 PowerShell 脚本，C#只能执行不能“解析AST”
PSM1 不是可反编译的二进制，也不是 C# 能静态分析的源码。它本质是 .ps1 脚本，只是约定扩展名和加载方式不同。你无法用 C# 提取其中的函数签名、参数列表或注释帮助（.SYNOPSIS）。想“解析”，只有两条路：执行后反射导出，或调用 PowerShell 的 Get-Command 和 Get-Help。
- 加载 PSM1 必须用
Import-Module -Name 'C:path oModule.psm1' -Force，不能用Invoke-Expression，否则函数不会注册进 session - 加载后执行
Get-Command -Module 'ModuleName'获取导出函数列表，模块名默认取文件名（不含扩展名），但可通过ModuleToProcess在 PSD1 中覆盖 - 若 PSM1 依赖其他模块，C# 中必须先确保那些模块已导入，PowerShell 不会自动解析
#requires并下载——那是Install-Module的事，C# 不管
跨版本兼容性陷阱：PowerShell Core（pwsh）和 Windows PowerShell（powershell.exe）行为不同
Import-PowerShellDataFile 在 PowerShell 5.1 和 7+ 都存在，但 7+ 默认禁用 Invoke-Expression 类型的回退路径，且对 Unicode BOM、注释位置更严格。Windows PowerShell 允许 PSD1 末尾多一个逗号，pwsh 会直接报错 Unexpected token ',' in expression or statement。
- 生成 PSD1 时，务必用
Export-PowerShellDataFile（v5.1+）或手动拼接哈希表后调用Out-File -Encoding UTF8NoBOM，避免记事本保存引入 BOM - C# 中判断当前环境：检查
Environment.GetEnvironmentVariable("PSModulePath")是否含powershell/7路径，或运行$PSVersionTable.PSVersion.Major获取主版本号 - 不要假设
PSModulePath一定包含你的模块目录——C# 进程启动时 PowerShell 运行时可能还没初始化模块路径，需显式追加：$env:PSModulePath = 'C:mymodules;' + $env:PSModulePath
真正麻烦的从来不是怎么读，而是 PSD1 里那个看似无害的 @{ ScriptsToProcess = @('init.ps1') } ——它会让 Import-PowerShellDataFile 静默失败，除非你提前把 init.ps1 放到正确路径下。这种依赖链，C# 没法替你 resolve。
