如何指定加载PowerShell模块版本，避免自动加载其他版本？

核心原因 #

你的PSModulePath同时包含了v1.0和v1.1的根目录，PowerShell会将这两个路径下的TestMod视为独立模块。当调用已加载的1.1版本未导出的f2函数时，PowerShell会遍历PSModulePath查找包含该导出函数的模块，找到v1.0版本后自动加载，导致多版本共存。

解决方案 #

1. 采用官方推荐的多版本模块结构（最优方案） #

PowerShell官方要求同模块的不同版本需放在同一模块文件夹的子目录下，调整后的结构如下：

P:\PS1\MyModules\TestMod\
├─ 1.0\
│  ├─ testMod.psd1
│  └─ testMod.psm1
└─ 1.1\
   ├─ testMod.psd1
   └─ testMod.psm1

然后修改PSModulePath，只添加模块根目录：

$env:PSModulePath += ';P:\ps1\MyModules'

这种结构下，PowerShell会自动识别同一模块的所有版本，加载指定版本后，调用未导出的函数时不会触发其他版本的自动加载。

2. 临时锁定PSModulePath（快速修复） #

如果无法调整目录结构，在加载指定版本前，临时移除PSModulePath中其他版本的路径：

# 保存原始路径
$originalPath = $env:PSModulePath
# 移除v1.0路径，只保留v1.1和系统默认路径
$env:PSModulePath = ($env:PSModulePath -split ';' | Where-Object { $_ -ne 'P:\ps1\MyModules\v1.0' }) -join ';'
# 加载指定版本
Import-Module -Name testMod -RequiredVersion 1.1 -Global
# 若后续需要恢复原始路径，可执行：
# $env:PSModulePath = $originalPath

3. 明确指定模块版本调用函数（应急方案） #

如果必须保留现有路径结构，调用函数时明确指定已加载的模块版本，避免触发自动加载：

# 调用1.1版本的f1
& (Get-Command -Module testMod -Version 1.1 f1)
# 若尝试调用未导出的f2，会直接报错，不会加载其他版本
& (Get-Command -Module testMod -Version 1.1 f2 -ErrorAction Stop)

验证测试 #

调整后执行你的测试脚本，调用f2时会抛出找不到命令的错误，不会自动加载v1.0版本，同时Get-Module testMod只会显示1.1版本。

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