VSCode配置PowerShell环境_Windows脚本编写效率提升方案

VSCode 能真正运行并调试 PowerShell 脚本的关键在于三步

想让 VSCode 顺畅地跑起 PowerShell 脚本，还能愉快地打断点调试？很多人第一步就错了——关键不在于你装没装那个 PowerShell 扩展，而在于背后三个环环相扣的配置：pwsh.exe 或 powershell.exe 是否被 VSCode 正确识别、终端是否默认调用它、以及执行策略是否允许本地脚本运行。这三步，漏掉任何一环，按下 F5 要么静默失败，要么直接给你来个“无法加载文件”的报错。

PowerShell 扩展装了但右下角不显示版本号

这大概是新手最容易踩的“第一坑”：明明扩展装好了，右下角却空空如也，很容易让人误判是扩展坏了。其实，真实原因很简单——VSCode 根本没找到可执行的 PowerShell 运行时。

• 先确认系统里有没有 PowerShell：按下 Win+R，输入 pwsh（对应 PowerShell 7+）或 powershell（对应 Windows PowerShell 5.1），能弹出来窗口就说明安装没问题。
• 如果命令没反应，直接去 PowerShell 的 GitHub Releases 页面下载 MSI 安装包，认准类似 pwsh-7.4.2-win-x64.msi 这种带架构标识的版本。这里有个小建议：尽量避开 Microsoft Store 版本，它的安装路径权限有时会比较棘手。
• 安装完成后，打开 VSCode 设置，搜索 powershell.defaultVersion，手动把它设置成 PowerShell 的完整路径，比如："C:\Program Files\PowerShell\7\pwsh.exe"。
• 改完重启一下 VSCode，再随便打开一个 .ps1 文件看看。这时候，右下角应该就会稳稳地显示出类似 PowerShell 7.4.2 的版本号了。

终端默认是 cmd/bash，不是 PowerShell

别高兴太早，版本号显示出来只是过了第一关。接下来你会发现，按下 Ctrl+` 新打开的终端，很可能还是 cmd 或者 bash。这会导致一个尴尬的局面：你手动执行 .script.ps1 会失败，甚至 F5 调试都可能跑错环境。

• 按下 Ctrl+Shift+P，调出命令面板，输入 Terminal: Select Default Profile 并回车。
• 从弹出的列表里，选择 PowerShell (pwsh)（推荐优先选这个）或者 PowerShell (Windows)。如果列表是空的，那大概率是上一步的 powershell.defaultVersion 没配对，或者系统的 PATH 环境变量里没包含 PowerShell 的目录。
• 确认之后，新打开的终端左上角标签应该会显示 PowerShell，命令提示符也会变成熟悉的 PS C:... 样式。
• 到了这一步，你右键脚本选择“Run PowerShell Script in Terminal”，或者直接在终端里输入 .script.ps1，命令才能真正跑在 PowerShell 的环境里。

F5 调试时断点不命中或报 Execution Policy 错误

这才是真正的“深水区”。VSCode 的调试器在启动时，会拉起一个全新的、独立的 PowerShell 会话。它既不会继承你在集成终端里设置过的执行策略，也不会去读你手动修改的注册表策略——它只认“当前用户（CurrentUser）”级别的策略，而且必须是 RemoteSigned 或更宽松的级别。

• 在 VSCode 的集成终端里（确保已经是 PowerShell 环境），执行这条命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
• 注意，不要加 -Force 参数，让它交互式地确认一下。如果提示需要管理员权限，那就关掉 VSCode，右键图标选择“以管理员身份运行”再重试。
• 接着，检查项目目录下 .vscode 文件夹里的 launch.json 文件。确认 script 字段用的是 ${file}，这是最稳妥的写法，能自动传入当前打开脚本的绝对路径。尽量避免手写相对路径，或者路径里包含中文、空格。
• 如果设置都对了，断点还是被跳过，可以点击右下角的 PowerShell 版本号，选择“Show Session Menu”，确认调试器使用的 PowerShell 版本和终端里的是同一个（比如都是 pwsh 7.4.2，而不是一个用 7.x，另一个用 5.1）。

调试控制台输出乱码或中文显示为方块

这个问题看似是字体，实则根源在于编码对不上。PowerShell 7+ 默认使用 UTF-8 编码，但老版本的 Windows PowerShell 5.1 默认却是 GBK（代码页 936）。而 VSCode 的终端，默认是按 UTF-8 来解码输出的，两边一打架，乱码就出来了。

• 对于 PowerShell 7+ 用户：通常无需额外操作。如果出现乱码，很可能是脚本里硬编码了类似 [Console]::OutputEncoding = [Text.Encoding]::GetEncoding(936) 的语句，把它删掉就好。
• 对于 Windows PowerShell 5.1 用户：在 launch.json 的 configurations 里加 "env": { "PYTHONIOENCODING": "utf-8" } 是没用的。正确的做法是在脚本开头加上一行：$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding。
• 想要一劳永逸？可以在用户目录下创建（或修改） Microsoft.PowerShell_profile.ps1 文件，把上面那行编码设置放进去。这样，所有新启动的 PowerShell 会话都会自动加载这个配置。

最后，必须提醒一点：调试器的环境隔离性是最容易被忽略的。它启动的那个全新会话，不会复用你在终端里用 Import-Module 加载的模块，也不会自动加载你的 profile 脚本，除非你显式配置。所以，别指望在断点停住后，能在调试控制台里直接调用你的自定义函数。要么提前确认模块路径是否在 $env:PSModulePath 里，要么就在 launch.json 的 preLaunchTask 里，把模块导入的逻辑补上。