Terminus 默认不自动识别 PowerShell,需手动配置 shell_configs 并设 default_config;PowerShell 启动卡顿多因 $PROFILE 加载慢或杀软拦截;Build System 需绑定语法作用域、绕过执行策略且文件编码为 UTF-8 无 BOM。

Terminus 默认 Shell 配置必须手动指定 PowerShell
Terminus 不会自动识别你系统里装了 PowerShell,更不会默认用它——即使你在 Windows 上。不配就只能用 cmd 或 bash(如果装了 Git Bash)。要让它真正启动 PowerShell,得改 shell_configs 设置,不是改“默认 shell”下拉菜单那种假配置。
打开 Terminus 设置(Preferences → Package Settings → Terminus → Settings),在右侧面板(用户设置)里填入类似这样的结构:
{
"shell_configs": [
{
"name": "PowerShell",
"cmd": ["powershell.exe", "-NoExit", "-Command", "Set-Location '%CWD%'"],
"env": {}
}
],
"default_config": "PowerShell"
}
关键点:
-
cmd数组必须写全路径或确保powershell.exe在PATH里;若装了 PowerShell 7+(pwsh.exe),就换掉名字,别硬套 -
-NoExit留住窗口,否则命令一跑完终端就关了 -
Set-Location '%CWD%'是为了进当前文件所在目录,%CWD%是 Terminus 特有的变量,不是 PowerShell 原生的 -
"default_config": "PowerShell"必须和name字段完全一致,大小写敏感
Ctrl+Shift+P 里选 “Open Default Shell” 没反应?检查 PATH 和初始化阻塞
点了 Terminus: Open Default Shell 却卡在空白面板、光标不动、输不了字——大概率是 PowerShell 启动时被自己的配置文件拖住了,比如 $PROFILE 里有 curl、nvm、oh-my-posh 加载慢,或者杀毒软件拦截。
快速验证方法:临时绕过所有 profile,用干净 shell 启动:
执行 Terminus: Open Shell in Panel,在弹出的输入框里粘贴这个 JSON:
{"cmd": ["powershell.exe", "-NoExit", "-NoProfile", "-Command", "Set-Location '%CWD%'"]}
如果这次能进,说明问题出在 $PROFILE;如果还是卡,就查 powershell.exe 是否真在 PATH 里,或者杀软是否静默拦截了进程创建。
常见坑:
- PowerShell 7+ 的
pwsh.exe默认不在PATH,得手动加到系统环境变量里 - 某些企业域策略会禁止
-NoProfile,此时只能优化$PROFILE,删掉阻塞语句 - 别在
cmd里写start powershell—— Terminus 要的是直接可 exec 的程序,不是启动器
Build System 里调用 PowerShell 和终端不是一回事
很多人混淆 Ctrl+B 和终端:前者是构建系统,跑完就结束,不能交互、不能输命令、不继承终端环境变量;后者才是真正的 PowerShell 会话。如果你只是想运行一个 .ps1 文件并看输出,用 Build System 更轻量;但想调试、补全、反复试命令,必须用 Terminus。
Build System 配置里也得绕过策略,否则 Ctrl+B 一定报错:
{
"cmd": ["powershell.exe", "-ExecutionPolicy", "Bypass", "-File", "$file"],
"selector": "source.powershell",
"shell": true,
"working_dir": "$file_path"
}
注意这三点:
-
-ExecutionPolicy Bypass是必须项,不是可选项;RemoteSigned在多数企业环境无效 -
"working_dir": "$file_path"显式设工作目录,否则脚本里./config.json会去 Sublime 安装目录找 -
"shell": true才能让$file展开为带空格/中文的绝对路径,否则路径截断成C:\My就崩了
为什么右下角显示 “PowerShell” 但 Ctrl+B 还是没反应
Sublime 不靠文件后缀(.ps1)触发构建系统,只认语法作用域(syntax scope)。右下角显示 “Plain Text”、“ShellScript” 或别的,哪怕文件名是 test.ps1,Ctrl+B 也不会调用 PowerShell 构建系统。
必须手动绑定语法:
- 装好
PowerShell插件(作者 jbrooksuk),重启 Sublime - 打开
.ps1文件,点右下角语言名 → 选PowerShell;或者按Ctrl+Shift+P→ 输入Set Syntax: PowerShell - 确认插件设置里
"extensions"包含"ps1":Preferences → Package Settings → PowerShell → Settings - 检查
PowerShell.sublime-build文件是否真在Packages/User/目录下(用Preferences → Browse Packages…打开)
最常被忽略的一点:文件编码要是 UTF-8 无 BOM。BOM 会导致 PowerShell 解析失败,报错不明显,只显示空输出或乱码。


















