VSCode中PowerShell的PSModulePath不生效问题求助

问题背景 #

已更新HKCU:\Environment\PSModulePath添加本地开发模块目录，Windows 11终端启动PowerShell 7.3.4时该目录已包含在$env:PSModulePath中，但VSCode正常启动时的PowerShell终端未包含；以管理员身份运行VSCode时则能正常加载，且两种模式下Get-ItemPropertyValue -Path HKCU:\Environment -Name PSModulePath返回值一致。

排查与解决步骤 #

1. 确保环境变量更新完全生效 #

• 关闭所有VSCode进程（任务管理器中结束所有Code.exe实例）
• 重启Windows资源管理器（任务管理器找到「Windows资源管理器」，右键选择「重启」），或直接重启电脑
• 正常启动VSCode，再次检查$env:PSModulePath是否包含目标目录

2. 手动配置VSCode终端的环境变量 #

• 打开VSCode设置（快捷键Ctrl+,），搜索terminal.integrated.env.windows
• 点击「编辑 in settings.json」，添加以下配置（替换为你的本地模块目录）：

  "terminal.integrated.env.windows": {
    "PSModulePath": "${env:PSModulePath};C:\\你的本地模块绝对路径"
  }
  

  保存后重启VSCode终端，验证变量是否生效

3. 检查VSCode启动方式 #

• 避免从旧终端会话启动VSCode：如果是从之前未更新环境变量的PowerShell窗口执行code命令启动，会继承旧环境，需关闭该终端后从开始菜单/桌面快捷方式重新启动
• 检查VSCode快捷方式属性：右键快捷方式→「属性」，确认「目标」和「起始位置」无异常参数，未添加环境变量覆盖逻辑

4. 排查PowerShell配置文件干扰 #

• 查看PowerShell用户配置文件路径：执行$PROFILE获取路径
• 临时重命名配置文件（如改为Microsoft.PowerShell_profile.ps1.bak），重启VSCode终端测试
• 若问题消失，说明配置文件中存在修改$env:PSModulePath的代码，需排查并调整逻辑（确保是追加而非覆盖）

5. 从正常环境的PowerShell启动VSCode #

• 打开Windows终端的PowerShell，确认$env:PSModulePath包含目标目录后，执行code命令启动VSCode
• 若此时VSCode终端能正常加载环境变量，说明原启动方式未获取到更新后的用户环境，可尝试重新创建VSCode快捷方式

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