答案:sublime text 通过原生 build system 调用系统 powershell 运行 .ps1 脚本,需配置 powershell.sublime-build 文件,包含绝对路径调用、-executionpolicy bypass、"shell": true、"selector": "source.powershell" 和 utf-8 编码等关键项,且必须安装 powershell 插件并设置正确语法高亮。

Sublime Text 本身不执行 PowerShell 脚本,它只调用系统里的 powershell.exe 或 pwsh.exe 去跑;配置失败的绝大多数情况,不是语法写错,而是执行策略、路径展开、编码三者没对齐。
为什么 Ctrl+B 后提示“无法加载文件,因为在此系统中禁止运行脚本”
这是 PowerShell 的 ExecutionPolicy 在拦截,和 Sublime 无关。默认策略(如 Restricted)会直接拒绝本地 .ps1 文件执行。
-
-ExecutionPolicy Bypass必须加在构建命令里,不能省——它是临时绕过,不改系统策略,最安全 - 别信“全局改策略”的教程:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser在企业环境常被组策略覆盖,且没必要 - 如果用了
pwsh.exe(PowerShell 7+),就别硬写powershell.exe,路径不对会报The system cannot find the file specified
PowerShell.sublime-build 文件必须放对位置、写对字段
构建系统文件名必须是 PowerShell.sublime-build,且只能存放在 Packages/User/ 目录下(可通过 Preferences → Browse Packages… 打开)。
-
"shell": true是必须项,否则$file变量不会展开成实际路径,尤其在 Windows 下会走 cmd 兼容层,导致Get-Process等命令输出乱码或失败 -
"cmd"字段推荐用绝对路径调用可执行文件,比如:"C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe",避免 PATH 查找失效 - 路径含空格或中文时,
"$file"必须用反斜杠转义双引号包裹:""$file""(JSON 字符串内需转义) -
"working_dir": "$file_path"要显式设置,否则脚本里.config.json这类相对引用会指向 Sublime 安装目录而非脚本所在目录
为什么 .ps1 文件打开后全是灰色、Ctrl+B 没反应
Sublime 不靠文件扩展名触发构建系统,而是靠右下角显示的语法作用域(syntax scope)。显示 “Plain Text” 或 “Shell Script” 都无效,必须是 source.powershell。
- 先装 PowerShell 插件:按
Ctrl+Shift+P→Package Control: Install Package→ 搜PowerShell(作者 jbrooksuk),安装后重启 - 打开一个
.ps1文件,点右下角语言名 → 选PowerShell;或者按Ctrl+Shift+P→Set Syntax: PowerShell - 确认
"selector": "source.powershell"和当前文件语法匹配,不匹配则构建系统根本不会被激活 - 如果文件本身是 UTF-8 with BOM 编码,PowerShell 可能报
File not found;建议用 Sublime 右下角编码菜单切到UTF-8(无 BOM)
中文输出乱码、错误行号点不跳转怎么办
默认编码和错误正则不匹配,会导致中文变问号、堆栈信息无法解析。
- 中文 Windows 下若用
cp936编码,Write-Host "测试"才能正常输出;但更推荐统一用UTF-8编码 +"encoding": "UTF-8",前提是脚本文件本身保存为 UTF-8(无 BOM) -
"file_regex"必须能捕获 PowerShell 错误中的行号,例如:"^.*?line (\d+).*?$",否则点击错误行不会跳转到对应位置 - 交互式脚本(如带
Read-Host)在 Sublime 构建面板里无法输入——这不是 bug,是设计限制;调试时得加ReadKey或改用cmd /c powershell -File "$file" & pause
最容易被忽略的是:PowerShell 插件已停更多年,别再装 PowerShell_Sublime 这类老插件;所有功能用原生 Build System 就够,但 shell、selector、encoding 这三个字段必须同时正确,缺一不可。











