sublime text 执行 powershell 脚本需同时满足:正确配置 powershell.sublime-build(放于 packages/user/、含 "shell": true、绝对路径调用、-executionpolicy bypass)、右下角语法设为 source.powershell、文件 utf-8 无 bom 编码、显式设置 working_dir。

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→PowerShell - 若想永久生效,可在
Packages/User/下新建PowerShell.sublime-settings,写入{"extensions": ["ps1", "psm1", "psd1"]}
调试时窗口一闪而逝,看不到错误堆栈?
直接运行 -File 时窗口一闪而逝,错误来不及看。这不是 Sublime 的 bug,而是 PowerShell 进程退出太快。
- 临时方案:在脚本末尾加一行
$host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")(比Read-Host更可靠,不依赖回车) - 更干净的做法:改构建系统,用
cmd /c包一层再加& pause,但注意引号嵌套和转义——推荐用这个安全写法:{ "cmd": ["cmd", "/c", "powershell.exe -ExecutionPolicy Bypass -NoProfile -File \"$file\" & pause"], "shell": true, "selector": "source.powershell", "working_dir": "$file_path" } - 别忽略
encoding:如果脚本含中文,确保文件本身是 UTF-8 编码(Sublime 右下角看,不是 UTF-8 with BOM),否则可能报File not found
最容易被忽略的其实是 selector 和 shell 的组合效果:即使所有路径、参数都对,只要右下角没显示 PowerShell,或者 "shell": true 写成 "shell": "true"(字符串而非布尔值),构建系统就完全不会激活。











