PowerShell高级函数调用Import-Module无法导入模块新更改问题

核心原因分析 #

你遇到的问题本质是两层缓存：

1. 用于管理模块的自定义脚本模块本身被PowerShell会话缓存，修改后的imp函数不会自动生效，导致执行的还是旧逻辑
2. 如果imp函数仅通过模块名导入，可能加载了PSModulePath中存在的旧版本模块，而非当前目录的最新更改

解决方案一：修正imp函数逻辑，强制加载当前目录的最新模块 #

更新你的imp函数，确保它优先定位当前目录下的模块清单文件（.psd1），而非依赖模块名查找：

function Import-LatestModule {
    [Alias('imp')]
    [CmdletBinding()]
    param()

    # 递归查找当前目录下的模块主清单（匹配目录名=清单文件名的规则）
    $targetPsd = Get-ChildItem -Path $PWD -Filter "*.psd1" -Recurse -Depth 2 | 
        Where-Object { $_.Directory.Name -eq $_.BaseName } |
        Select-Object -First 1

    if (-not $targetPsd) {
        Write-Error "未在当前目录找到有效的PowerShell模块清单"
        return
    }

    # 从清单中获取模块名，确保移除的是正确的模块
    $moduleMeta = Import-PowerShellDataFile -Path $targetPsd.FullName
    $moduleName = $moduleMeta.RootModule ? [System.IO.Path]::GetFileNameWithoutExtension($moduleMeta.RootModule) : $targetPsd.BaseName

    # 强制移除已加载的模块实例
    Remove-Module -Name $moduleName -Force -ErrorAction SilentlyContinue

    # 强制导入当前目录的最新模块
    Import-Module -Path $targetPsd.FullName -Force -Verbose
}

解决方案二：确保管理模块本身的更改生效 #

每次修改管理模块中的imp函数后，必须强制重新加载管理模块，否则PowerShell会继续使用会话中缓存的旧版本：

Import-Module 你的管理模块名称 -Force

替代方案：将imp函数加入PowerShell配置文件 #

如果不想频繁重新加载管理模块，可以把imp函数直接写入你的PowerShell配置文件（$PROFILE）：

1. 编辑配置文件：notepad $PROFILE
2. 将上述Import-LatestModule函数粘贴进去并保存
3. 重启PowerShell或执行. $PROFILE使更改生效
   这种方式下，修改函数后只需重新加载配置文件即可，无需管理额外模块。

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