PowerShell中Import-Module导入PSM1文件的底层运行原理是什么

1. 前置校验阶段 #

• 首先PowerShell会校验传入的PSM1路径合法性：相对路径会自动转换为绝对路径，同时检查文件是否存在、后缀是否为.psm1、当前进程是否持有该文件的读取权限。
• 接着校验模块加载策略：如果未指定PSM1的完整路径，会遍历$env:PSModulePath下的所有目录匹配目标文件；同时核对当前PowerShell的执行策略（可通过Get-ExecutionPolicy查询）是否允许运行对应签名等级的脚本文件，不符合规则会直接抛出权限异常。
• 最后做重复加载校验：查询当前会话的已加载模块列表（Get-Module），如果该PSM1对应的模块已完成加载，默认会直接跳过导入流程，除非追加-Force参数强制重新加载。

2. 脚本解析与编译阶段 #

• 读取PSM1文件的全部文本内容，调用PowerShell内置的脚本解析器将文本转换为抽象语法树（AST）。
• 对AST做静态语法校验，识别其中的函数、变量、别名、类、枚举等成员定义，检查是否存在语法错误，存在错误会直接抛出加载异常终止流程。
• 把校验通过的AST编译为可执行的中间字节码，存储到临时的脚本块对象中等待执行。

3. 模块上下文初始化阶段 #

• 为当前PSM1模块创建独立的模块会话状态，和用户当前的会话作用域完全隔离：模块内定义的普通变量、函数默认不会污染用户会话，除非显式用$global:前缀修饰成员。
• 初始化模块内置变量：$PSScriptRoot自动赋值为PSM1文件所在目录，$MyInvocation填充模块的调用信息，$PSCommandPath赋值为PSM1文件的完整绝对路径。
• 如果PSM1同目录下存在配套的.psd1模块清单文件，会优先加载清单配置，读取其中的RootModule、RequiredModules、FunctionsToExport等规则，后续的成员导出流程会以清单配置为最高优先级。

4. 模块执行与成员导出阶段 #

• 在独立的模块会话状态中运行之前编译好的PSM1字节码，执行模块内的所有顶层代码：比如初始化模块全局变量、注册系统事件、加载依赖资源文件等。
• 收集模块内的所有可导出成员：默认导出所有自定义函数，变量、别名、类默认不导出，除非用Export-ModuleMember显式指定导出项，或在.psd1清单中配置了对应导出规则。
• 把符合导出规则的成员挂载到用户当前的会话作用域中，用户可直接调用这些导出成员。

5. 收尾注册阶段 #

• 把该模块的完整信息注册到当前会话的已加载模块列表中，包含模块名称、版本、存储路径、导出成员列表、加载时间等信息。
• 如果PSM1中定义了OnRemove回调事件，会将该回调绑定到模块的卸载事件中，后续调用Remove-Module卸载模块时会自动触发该回调。

内容的提问来源于stack exchange，提问作者Pratap Singh Ranawat