Sublime Text 通过构建系统调用系统 PowerShell 运行 .ps1 脚本,核心要求是:配置 PowerShell.sublime-build 文件于 Packages/User/ 目录,cmd 中使用绝对路径和 -ExecutionPolicy Bypass,启用 "shell": true 以展开 $file,设置 "working_dir": "$file_path",并确保文件语法为 source.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 → PowerShell - 若想永久生效,用
Ctrl+Shift+P执行Set Syntax: PowerShell,或在Packages/User/下新建PowerShell.sublime-settings,写入{"extensions": ["ps1", "psm1", "psd1"]}
运行后窗口一闪而过,看不到输出结果
PowerShell 脚本执行完立即退出,不像 CMD 那样有 pause。别在脚本末尾硬加 Read-Host——它依赖回车,且可能被管道/重定向干扰。
- 临时调试时,在脚本末尾加一行:
$host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")(比Read-Host更可靠) - 更干净的做法是改构建系统:把
"cmd"改成调用cmd /c包一层再加& pause,但注意引号嵌套和转义 - 确保文件本身是 UTF-8 编码(Sublime 右下角看,不是 UTF-8 with BOM),否则中文可能乱码或报
File not found
最容易被忽略的是:构建系统是否真正激活——它只在文件语法被识别为 source.powershell 时才响应 Ctrl+B;哪怕配置全对,右下角显示的是 “Plain Text”,那一切参数都白搭。

















