Sublime Text 无法通过 SSH 直接运行远程代码，因其无终端集成、不启动远程进程，也不支持 ssh user@host 'cmd' 类命令；实际需依赖 Terminus 插件开 SSH 终端手动执行，或配合 SFTP 同步后用自定义 Build System 调用本地 ssh 命令（需免密登录、正确环境及路径同步）。
Sublime Text 本身不能通过 SSH 直接运行远程服务器上的代码——它没有终端集成、不启动远程进程、也不支持 ssh user@host 'python script.py' 这类命令式执行。所谓“运行远程代码”，实际是靠本地编辑 + 外部终端/插件触发 + 手动或半自动调用远程命令实现的，核心依赖你已有可用的 SSH 连接。
为什么 Sublime 的 Build System 无法直接 ssh 运行远程代码
subl 命令和 Sublime 的构建系统（Build System）只在本地执行 shell 命令，且默认不加载你的 SSH 配置（如 ~/.ssh/config）、不继承 SSH agent 环境、也不处理密钥跳转（ProxyJump）或自定义端口。你写一个 build 文件里包含 ssh user@host python3 /path/script.py，大概率会卡住、报错 Permission denied (publickey) 或 Pseudo-terminal will not be allocated。
- 构建系统运行的是本地 shell 子进程，不是你当前终端的完整环境
- 没有 TTY 分配时，很多远程命令（尤其是带交互或颜色输出的）会失败或截断
-
ssh命令若依赖ssh-agent，而 Sublime 启动时未继承该环境，就会静默失败
可行方案：用 Terminus 插件 + SSH 终端手动运行
这是最稳定、最可控的方式：把远程执行当成「操作」而非「构建」，避免绕过 Shell 环境限制。
安装
Terminus插件（通过 Package Control），它提供内嵌终端，能完整复现你本地终端的 SSH 行为在 Sublime 中打开项目后，按
Ctrl+Shift+P→ 输入Terminus: Open Default Shell in Panel在终端面板中手动执行：
ssh -t user@host 'cd /remote/project && python3 main.py'-t强制分配伪终端，避免输出被截断或命令退出异常-
若需频繁运行，可保存为
Terminus的 profile（在Preferences → Package Settings → Terminus → Settings中添加）：{ "profiles": { "my-remote-python": { "cmd": ["ssh", "-t", "user@host", "cd /remote/project && python3 main.py"] } } } 注意：
Terminus不会自动同步文件——你得先确保远程目录已更新（比如用 SFTP 插件上传，或rsync同步）
进阶方案：配合 SFTP upload_on_save + 自定义 Build System
适合“改完就跑”的轻量脚本场景，但必须满足几个硬条件：
- 远程服务器已配置好免密 SSH（密钥认证，
ssh user@host能直连） - 本地
ssh命令能访问到ssh-agent（macOS/Linux 通常默认；Windows 需确认 WSL2 或 Git Bash 环境） - 远程路径固定，且有执行权限（如
chmod +x或python3可达）
示例 Build System（保存为 Python Remote.sublime-build）：
{
"shell_cmd": "ssh -o ConnectTimeout=5 -o BatchMode=yes user@host 'cd /home/user/project && python3 ${file_base_name}.py'",
"working_dir": "$file_path",
"selector": "source.python",
"variants": [
{
"name": "Run on Server (with output)",
"shell_cmd": "ssh -t -o ConnectTimeout=5 user@host 'cd /home/user/project && python3 ${file_base_name}.py'"
}
]
}
-
BatchMode=yes防止卡在密码提示 -
${file_base_name}是 Sublime 内置变量，取当前文件名不含扩展 - 必须确保你编辑的是本地副本，且已通过 SFTP 插件或
rsync同步到远程对应路径
别指望 Docker 或容器内直接运行——Sublime 没有 runtime 抽象层
有人想用 docker exec 或 podman run 在远程宿主机上运行容器内代码，这在 Sublime 里依然属于“外部命令调用”范畴。你得自己保证：
- 远程宿主机已安装 Docker 并配置好用户权限（
user在docker组） - 容器已启动且挂载了正确卷（如
-v /host/path:/app），否则exec找不到文件 - 构建系统里写的
ssh host 'docker exec myapp python /app/script.py'仍受前述 SSH 环境限制
更现实的做法是：用 SFTP 同步代码 → 在 Terminus 里手动 docker exec -it 进去调试 → 把常用命令做成 Terminus profile。
真正容易被忽略的一点：Sublime 从不管理远程状态。它不知道远程 Python 是否装了依赖、Docker 容器是否重启过、requirements.txt 是否已 pip install。所有这些都得你人工保障。一旦远程环境变化，本地 Build System 就会静默失败或报错模糊——这时候别查 Sublime 设置，先 ssh 登上去看日志。
