PowerShell 5/7已安装模块命令加载行为差异原因及解决咨询

一、PowerShell 5与PowerShell 7默认加载模块版本不同的原因 #

二者核心差异在于模块版本选择逻辑的设计不同：

• Windows PowerShell 5.x：会遍历所有PSModulePath中的路径，收集该模块的所有可用版本，最终选择版本号最高的模块加载，不受路径优先级的影响。
• PowerShell 7+：严格遵循PSModulePath的路径顺序，按顺序遍历每个路径，一旦在某个路径下找到该模块的目录，就加载该路径下的最高版本模块，不会继续遍历后续路径寻找更高版本。

补充：PSResourceGet模块在不同PowerShell版本下的默认安装路径也存在差异——它会根据当前PowerShell版本，将模块安装到对应版本的专属模块目录中，这也可能导致两个环境下可用的模块版本范围不同，进一步加剧加载版本的差异。

二、PowerShell 7中规避该问题的其他方法 #

除了Import-Module -Version <版本号>，还有以下几种可行方案：

• 调整PSModulePath优先级：将存放高版本模块的路径移到PSModulePath的最前面，让PS7优先搜索该路径。会话内临时生效命令：

  $env:PSModulePath = "C:\Program Files\PowerShell\Modules;$env:PSModulePath"
  

  若要永久生效，可将该命令添加到PowerShell 7的配置文件（执行$PROFILE查看具体路径）中。
• 使用PSResourceGet原生命令加载：用Import-PSResource直接指定版本，适配PSResourceGet的模块管理逻辑：

  Import-PSResource -Name <模块名> -Version <目标版本号>
  

• 通过完整路径加载：直接指定高版本模块的清单文件路径，跳过系统路径搜索逻辑：

  Import-Module "C:\Program Files\PowerShell\Modules\<模块名>\<版本号>\<模块名>.psd1"
  

• 脚本中添加版本强制指令：在需要使用指定版本模块的脚本开头添加：

  #Requires -Module <模块名>, Version=<目标版本号>
  

  脚本运行时会自动加载指定版本的模块，若找不到则直接报错终止执行。
• 指定安装路径：使用PSResourceGet安装模块时，用-Path参数将高版本模块安装到PS7优先搜索的目录：

  Install-PSResource -Name <模块名> -Version <目标版本号> -Path "C:\Program Files\PowerShell\Modules"
  

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