为何PowerShell持续加载已废弃模块？VSCode调试异常排查

我在Visual Studio Code (VSC)中创建了新工作区，将旧工作区的PowerShell脚本和模块复制过来并重命名所有文件，更新了所有using和Import-Module语句，且通过工作区搜索确认源代码中无旧名称提及。但运行脚本时出现错误：

The 'Get-Arguments' command was found in the module 'TchPublisherArguments', but the module could not be loaded. For more information, run 'Import-Module TchPublisherArguments'.

其中TchPublisherArguments是旧工作区的已废弃模块，本应加载新版本WebPublisherArguments。

按提示运行Import-Module无输出或错误；执行Uninstall-Module -name TchPublisherArguments后错误消失，但调试脚本时，初始正常，几次函数调用后调试器会进入旧工作区模块的源代码，而点击调用行的函数名却能打开新工作区的正确模块。

运行Get-Module -ListAvailable仍同时显示旧模块TchPublisherArguments和新模块WebPublisherArguments。我从环境变量PSModulePath中移除了TchPublisherArguments.psm1所在文件夹，注销重启后问题依旧；重启机器后问题仍存在。

我的VSC版本为1.81.0，$PSVersionTable信息如下：

PSVersion                      7.3.6
PSEdition                      Core
GitCommitId                    7.3.6
OS                             Microsoft Windows 10.0.19045
Platform                       Win32NT
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

1. PowerShell模块缓存残留：PowerShell会缓存已加载模块的元数据（包括命令与模块的关联），即使删除旧模块文件，缓存中的命令关联信息可能未被清理，导致调用Get-Arguments时仍指向旧模块。
2. VSC调试会话缓存：VSC的PowerShell扩展会保留调试会话的上下文，旧工作区的模块路径可能被缓存到会话中，调试时仍会读取旧路径的代码。
3. 模块安装位置未完全清理：Uninstall-Module仅移除通过PowerShell Gallery安装的模块，若旧模块是手动放置在其他未被PSModulePath覆盖的位置（如用户文档的PowerShell模块目录、VSC工作区的隐含路径），Get-Module -ListAvailable仍能检测到它。

• 清理PowerShell模块缓存

  1. 关闭所有PowerShell会话和VSC窗口。
  2. 删除以下路径的缓存文件：
     • %USERPROFILE%\AppData\Local\Microsoft\Windows\PowerShell\ModuleAnalysisCache
     • %USERPROFILE%\AppData\Local\Microsoft\PowerShell\7\ModuleAnalysisCache（针对PowerShell Core）
  3. 删除后重新打开PowerShell和VSC。

• 彻底移除旧模块文件

  1. 运行Get-Module -ListAvailable TchPublisherArguments，查看旧模块的安装路径。
  2. 手动删除该路径下的整个TchPublisherArguments文件夹，不要只删除单个.psm1文件。
  3. 再次运行Get-Module -ListAvailable TchPublisherArguments确认已移除。

• 重置VSC PowerShell扩展上下文

  1. 打开VSC，按下Ctrl+Shift+P打开命令面板。
  2. 执行PowerShell: Restart Current Session命令，重置当前PowerShell会话。
  3. 若问题仍存在，执行Developer: Reload Window重新加载VSC窗口。

• 检查并清理模块依赖

  1. 检查新模块WebPublisherArguments的代码，确认是否有隐藏的旧模块引用（如硬编码的模块名称、配置文件中的引用）。
  2. 检查脚本运行时是否动态修改了$env:PSModulePath，导致旧路径被重新添加。

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