Sublime Text默认不能直接运行代码,因其不预装编译器、未绑定快捷键且未配置环境变量;所有“一键运行”需手动配置编译器PATH、构建系统及快捷键。

Sublime Text装完默认不能直接运行代码,不是你漏了步骤,是它压根没预装编译器、没绑定快捷键、也没配好环境变量——所有“一键运行”都得手动补全。
为什么Ctrl+B没反应或报错g++: command not found
Sublime Text 的 Ctrl+B 只是调用构建系统(Build System),不自带任何编译器。Windows 上常见错误包括:g++: command not found、[WinError 2] 系统找不到指定的文件、或 Python 报 'python' is not recognized。
- 根本原因:系统 PATH 里没有对应解释器/编译器,或 Sublime 没读到
- 验证方式:关掉 Sublime,新开一个终端(cmd 或 PowerShell),直接输
python --version或g++ --version—— 必须有输出才算真正就位 - MinGW-w64 路径别只加到用户 PATH,要加进系统 PATH;且路径末尾必须是
mingw64\bin,不能是mingw64或mingw64\ - Python 用户注意:
python和python3命令可能不同,根据where python或where python3输出选对 cmd 字段
如何写一个能跑通的Python3.sublime-build
这个文件决定你按 Ctrl+B 时到底执行什么命令。关键字段只有三个:cmd、selector、file_regex,其余都是可选。
-
cmd必须是数组形式:["python", "-u", "$file"],不能写成字符串"python -u $file"(除非加"shell": true,但不推荐) -
-u参数很重要:强制 Python 使用未缓冲输出,否则 print() 可能卡住不刷新,尤其带循环或 input() 时 -
selector设为"source.python"后,新建 .py 文件会自动关联该构建系统,不用每次手动选 - 中文乱码?别改
encoding字段,那是给 Sublime 读构建脚本用的;真正生效的是终端编码 —— Windows 下加"cmd": ["chcp 65001 >nul & python -u", "$file"]并设"shell": true - 保存路径必须是
Packages/User/Python3.sublime-build,通过Preferences → Browse Packages进去确认位置
F5 编译+运行 C++ 的快捷键怎么生效
默认 F5 是空的,想让它“先编译再执行”,不能只改构建系统,还得手动绑定快捷键。
- 打开
Preferences → Key Bindings,编辑右侧(用户配置)JSON - 加一条:
{"keys": ["f5"], "command": "build", "args": {"build_system": "Packages/User/C++17.sublime-build"}} - 注意:
build_system的路径必须和你保存的文件名完全一致,大小写、空格、扩展名都不能错 -
$file_base_name.exe在 Windows 下必须带.exe,Linux/macOS 构建命令里要删掉后缀,否则生成失败 - 如果想在终端里运行(支持
input()),不要用默认输出面板,改用Terminus插件 +"target": "terminus_exec"构建项
data 目录才是真正的便携核心
很多人以为复制整个安装目录就能“绿色运行”,结果换台电脑插 U 盘一开,插件全丢、设置归零——问题出在没接管配置路径。
- 删掉
%APPDATA%\Sublime Text\下所有内容,新建同级data文件夹(全小写,大小写敏感) - 把
sublime_text.exe和data放同一层目录下,双击启动即自动使用该data - 验证方式:
Preferences → Browse Packages显示路径应为your/path/to/data/Packages,而不是%APPDATA% - Package Control、插件、用户设置、缓存、甚至最近打开的文件列表,全部落在
data里,U 盘一拔就走
最容易被忽略的是:构建系统文件名、cmd 中的路径、key bindings 里的字符串,三者必须严格一致且大小写敏感;Windows 下 PATH 和终端编码这两关不过,再好的 JSON 也白搭。


















