sublime text 通过构建系统调用系统 powershell 运行 .ps1 脚本，核心需满足三者对齐：-executionpolicy bypass 参数必须写入 cmd、$file 变量须由 "shell": true 正确展开、语法作用域必须为 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（不是ShellScript） - 若想永久绑定所有
.ps1文件，点击右下角 →Open all with current extension as…→PowerShell - 或者在
Packages/User/下新建PowerShell.sublime-settings，写入：{"extensions": ["ps1", "psm1", "psd1"]}
调试时窗口一闪而逝、看不到错误堆栈
直接运行 -File 时窗口一闪而逝，错误来不及看。这不是构建配置问题，而是 PowerShell 行为本身。
- 临时调试：在脚本末尾加一行：
$host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")（比Read-Host更可靠，不依赖回车） - 更干净的做法是改构建系统，用
cmd /c包一层再加& pause，但注意引号嵌套和转义——推荐这个安全写法："cmd": ["cmd", "/c", "powershell.exe -ExecutionPolicy Bypass -NoProfile -File \"$file\" & pause"] - 中文输出乱码？加
"encoding": "cp936"（Windows 默认 GBK 编码），否则Write-Host "你好"可能变成问号
真正卡住人的地方，往往不是 JSON 写错，而是 $file 没展开、source.powershell 没匹配、或 ExecutionPolicy 没绕过——这三者缺一不可，且顺序和写法都敏感。
