VSCode中Microsoft.VSCode_profile.ps1执行后PSModulePath被覆盖

Windows配置文件位于网络驱动器，我不希望将其作为PowerShell模块的默认存储位置。为实现自动化配置，我按$PROFILE指示创建了Microsoft.VSCode_profile.ps1，在其中编写脚本修改$env:PSModulePath环境变量，但之后似乎有其他设置或脚本自动恢复了它。

在Microsoft.VSCode_profile.ps1中添加了如下代码：

# 此处为修改 $env:PSModulePath 的代码
Write-Output "Module Path at the end of Microsoft.VSCode_profile.ps1: "
Write-Output $env:PSModulePath

启动扩展时终端输出符合预期：

PowerShell Extension v2023.8.0
Copyright (c) Microsoft Corporation.

https://aka.ms/vscode-powershell
Type 'help' to get help.

Module Path at the end of Microsoft.VSCode_profile.ps1: 
C:\Users\xxxx\Documents\Powershell\Modules;C:\Program Files\PowerShell\Modules;<etc>

但在集成终端查看时，UNC路径被重新插入：

PS> $env:PSModulePath
\\<server>\<homedir>\Data\My Documents\PowerShell\Modules;C:\Users\xxxx\Documents\Powershell\Modules;<etc>

请问哪些脚本会在Microsoft.VSCode_profile.ps1执行后运行？该如何解决此问题？

一、可能在Microsoft.VSCode_profile.ps1之后执行的脚本/流程 #

• PowerShell全局/用户级配置文件：PowerShell存在多个层级的配置文件，优先级低于VSCode专属profile但会在其后执行，比如：
  • $PROFILE.CurrentUserAllHosts（对应Documents\PowerShell\Profile.ps1）
  • $PROFILE.AllUsersAllHosts（对应Program Files\PowerShell\7\Profile.ps1）
    这些文件中的代码可能会覆盖你对PSModulePath的修改。
• VSCode PowerShell扩展初始化逻辑：扩展自身的会话初始化流程，可能在profile执行后重新读取系统环境变量或默认配置，重置PSModulePath。
• 系统/域环境强制配置：如果域组策略或系统级环境变量中定义了包含UNC路径的PSModulePath，PowerShell在启动后期会自动合并这些值。
• 第三方模块启动脚本：自动加载的第三方模块，其初始化脚本可能会修改PSModulePath。

二、解决方法 #

1. 直接修改持久化环境变量 #

跳过profile临时修改，直接修改系统或用户级环境变量：

• 打开「系统属性」→「高级」→「环境变量」，找到PSModulePath变量（用户或系统级），移除UNC路径条目，添加你需要的本地路径。
• 该修改是持久化的，PowerShell启动时会直接读取修改后的值，避免后续被覆盖。

2. 强制VSCode扩展使用自定义路径 #

在VSCode设置中（按Ctrl+,打开），搜索powershell.additionalSessionDetails，添加如下配置：

"powershell.additionalSessionDetails": {
    "environmentVariables": {
        "PSModulePath": "C:\\Users\\xxxx\\Documents\\Powershell\\Modules;C:\\Program Files\\PowerShell\\Modules;<etc>"
    }
}

该配置会在会话启动时直接注入环境变量，优先级高于profile和扩展的自动初始化逻辑。

3. 检查并调整其他配置文件 #

运行以下命令列出所有PowerShell配置文件路径：

$PROFILE | Get-Member -MemberType NoteProperty | Select-Object Name, Value

逐一检查这些路径下的脚本，将你的PSModulePath修改逻辑移到最后执行的配置文件中（比如$PROFILE.CurrentUserAllHosts），确保你的修改覆盖其他设置。

4. 追踪变量修改来源 #

如果不确定是哪个流程修改了变量，在Microsoft.VSCode_profile.ps1开头添加日志追踪：

Start-Transcript -Path "$HOME\Desktop\PSModulePathTrace.log" -Append
# 你的修改代码
Write-Output "Initial modified path: $env:PSModulePath"

操作后执行Stop-Transcript，查看日志文件中PSModulePath的变化过程，定位修改来源。

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