VSCode 能真正运行并调试 PowerShell 脚本的关键在于三步：正确识别 pwsh/powershell 可执行文件、终端默认调用 PowerShell、设置 CurrentUser 执行策略为 RemoteSigned；任一缺失均导致 F5 失败或“无法加载文件”报错。
VSCode 能真正跑起 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，手动设为完整路径，例如："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，提示符为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 图标 → “以管理员身份运行”后再执行 - 检查
launch.json中script字段是否用了${file}：这是最安全的写法，自动传入当前打开的 .ps1 绝对路径；避免手写相对路径或含中文/空格的路径 - 若仍跳过断点，点击右下角 PowerShell 版本号 → “Show Session Menu” → 确认调试用的是和终端一致的版本（比如都是 pwsh 7.4.2，而非一个用 7.x、一个用 5.1）
调试控制台输出乱码或中文显示为方块
这不是字体问题，而是 PowerShell 默认编码与 VSCode 终端编码不一致导致的。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 里补上导入逻辑。
