Sublime Text 配置 PowerShell 脚本环境：从语法高亮到一键调试的完整指南

如果你直接用 Sublime Text 打开一个 .ps1 文件，大概率会看到一片“灰蒙蒙”的纯文本。变量、命令、字符串全都一个颜色，毫无语法高亮可言。别误会，这不是 Sublime 出问题了，而是它压根就没把 .ps1 文件识别为 PowerShell 脚本。

如何让 .ps1 文件正确高亮？

其实，Sublime 右下角的状态栏就藏着答案。那里显示着当前文件的语法类型（比如 “Plain Text”），点一下就能切换。直接选择 “PowerShell”，当前文件立刻就有了颜色。但问题是，这招只对当前文件管用，下次再开一个 .ps1 文件，一切又得重来。

想要一劳永逸？你需要做两件事：安装插件，然后绑定文件扩展名。

• 首先，用 Ctrl+Shift+P 打开命令面板，输入 Package Control: Install Package，搜索 PowerShell。这里有个关键点：认准作者是 jbrooksuk 的版本，一些年久失修的老插件可能已经无法适配新版 Sublime 了。
• 插件安装成功后，语法高亮通常会自动生效。如果没生效，可以再次点击右下角的语法名，找到 Open all with current extension as… 这个选项，然后选择 PowerShell。这相当于告诉 Sublime：“以后所有 .ps1 结尾的文件，都按 PowerShell 的规则来着色。”
• 如果还是不放心，可以进入 Preferences → Package Settings → PowerShell → Settings，检查一下 "extensions" 这个配置列表里，是否已经包含了 "ps1"。

Ctrl+B 运行 .ps1 脚本失败：不是内部或外部命令

语法高亮只是第一步，真正的“拦路虎”往往出现在运行环节。当你满怀期待地按下 Ctrl+B，却弹出一个“不是内部或外部命令”的错误——这太常见了。

原因在于，Sublime Text 默认的构建系统调用的是 cmd.exe，而 .ps1 文件在 cmd 眼里根本就不是可执行程序。你必须明确告诉 Sublime 去调用 powershell.exe 或 pwsh.exe（PowerShell Core）。更棘手的是，路径不能依赖环境变量，因为在64位系统上，Sublime 有时会以32位进程启动，导致它找不到系统 PATH 里的 PowerShell。

• 解决方案是创建一个专属的构建系统。通过菜单 Tools → Build System → New Build System… 新建一个文件。
• 将以下配置粘贴进去，然后保存为类似 PowerShell.sublime-build 的名字：

  {
      "cmd": ["C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe", "-ExecutionPolicy", "Bypass", "-NoProfile", "-File", "$file"],
      "selector": "source.powershell"
  }

• 如果你已经升级到 PowerShell 7+，更推荐使用 pwsh.exe：

  {
      "cmd": ["pwsh.exe", "-ExecutionPolicy", "Bypass", "-NoProfile", "-File", "$file"],
      "selector": "source.powershell"
  }

  前提是 pwsh.exe 的路径在 Sublime 可访问的范围内。
• 注意，配置里的 "selector": "source.powershell" 至关重要。它确保了只有当你在编辑 PowerShell 文件时，按 Ctrl+B 才会启用这个构建系统，而不会干扰其他语言。

运行后窗口一闪而过，看不到输出

脚本能运行了，但输出窗口一闪即逝，根本看不清结果？这感觉就像看了一场没有字幕的默片。PowerShell 脚本执行完毕后会立即关闭控制台窗口，这与在 CMD 里运行 .bat 文件后需要加 pause 是一个道理，但 PowerShell 并没有内置的 pause 命令。

一个常见的误区是在脚本末尾硬塞一个 Read-Host。这个方法并不总是可靠，因为它依赖用户按下回车键，而且在脚本输出被重定向时可能会失效。

• 在调试阶段，最稳妥的方法是使用 $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")，把它放在脚本的最后一行。它能捕获任意按键，稳定性更好。
• 如果想从构建系统层面一劳永逸地解决，可以修改之前的构建配置，用 cmd /c 包装一下命令：

  {
      "cmd": ["cmd", "/c", "powershell.exe -ExecutionPolicy Bypass -NoProfile -File \"$file\" & pause"],
      "selector": "source.powershell",
      "working_dir": "$file_path"
  }

  注意这里对双引号进行了转义。
• 说到 "working_dir": "$file_path"，这个参数千万别忽略。它确保脚本运行时的工作目录是脚本文件所在的文件夹。否则，脚本里任何基于相对路径的文件读写操作都会失败，错误原因还特别难排查。

最后，还有两个真正影响调试效率的细节，很容易被忽略。

第一个是 file_regex。如果不配置这个，当 PowerShell 报错显示 At line:5 char:12 时，你无法直接点击错误信息跳转到对应的代码行，只能手动去数行号。推荐在构建配置中加入：

"file_regex": "^.*?\\s*At\\s+([^:]+):(\\d+)\\s+char:(\\d+)\\s*"

第二个是编码问题。如果脚本输出中文时出现乱码，问题通常不在脚本本身，而是构建系统没有指定正确的编码。在构建配置里加上 "encoding": "utf-8" 通常就能解决（不建议使用 cp936）。PowerShell 默认输出可能是 UTF-16，但 Sublime Text 的构建输出面板能很好地处理 UTF-8 编码。

把这些细节都调校好，才能在 Sublime Text 里获得流畅、高效的 PowerShell 脚本编写与调试体验。否则，写再多的代码，也像是在迷雾中摸索。