文章导读

如何在SublimeText中配置C++开发环境？快速搭建C++项目的教程

作者 2025年9月6日 14

答案是配置sublime Text的C++开发环境需安装编译器并设置构建系统。首先安装MinGW-w64并配置PATH，验证g++可用；接着在Sublime中创建C++.sublime-build文件，定义编译和运行命令；推荐添加Run (console)变体以支持交互输入；然后通过Package Control安装C++ Extended、Terminus等插件提升体验；调试时可用Terminus结合GDB命令行操作；多文件项目建议使用Makefile管理构建过程。

要在sublime text中配置C++开发环境，核心在于安装一个C++编译器（如MinGW-w64或Clang），并将其路径添加到系统环境变量，接着在Sublime Text中创建或修改一个构建系统（Build System），以便编辑器能够调用编译器来编译和运行C++代码。对于更进阶的需求，可以通过安装Package Control和相关插件来增强代码补全、语法检查和有限的调试能力。

解决方案

配置Sublime Text作为C++开发环境，本质上是让这个强大的文本编辑器能够与外部的C++工具链（编译器、链接器等）协同工作。下面我将一步步带你完成这个过程，并分享一些我的经验。

第一步：安装C++编译器

这是所有配置的基础。Sublime Text本身不包含编译器，它只是一个文本编辑器。对于windows用户，我强烈推荐MinGW-w64，它提供了GCC工具链，支持最新的C++标准。

立即学习“C++免费学习笔记（深入）”；

下载MinGW-w64： 访问MinGW-w64官方网站。通常，我会选择一个最新的稳定版本，比如
```
x86_64-posix-seh
```
或
```
x86_64-w64-mingw32
```
系列，根据你的系统架构和个人偏好来选。
```
posix
```
通常意味着更好的多线程支持，而
```
seh
```
是异常处理模型。
解压与安装： 将下载的压缩包解压到一个你方便管理的目录，比如
```
C:MinGW
```
。切记： 路径中不要有空格或中文，这在编译时会带来很多不必要的麻烦。
配置环境变量PATH：
- 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”下找到
  Path
  变量，双击编辑。
- 点击“新建”，然后添加你的MinGW安装目录下的
  bin
  文件夹路径，例如
```
C:MinGWmingw64in
```
  。
- 点击确定保存所有更改。
- 验证： 打开命令提示符（
  cmd
  ），输入
```
g++ -v
```
  。如果显示了GCC的版本信息，说明安装成功且PATH配置正确。如果提示“g++不是内部或外部命令”，那你就需要仔细检查PATH路径是否拼写正确，或者重启一下系统。

第二步：配置Sublime Text的构建系统（Build System）

这是让Sublime Text知道如何编译和运行C++代码的关键。

打开Sublime Text。
创建新的构建系统： 点击菜单栏
```
Tools
```
->
```
Build System
```
->
```
New Build System...
```
。
粘贴以下配置代码：
```
{     "shell_cmd": "g++ "${file}" -o "${file_base_name}" -Wall -g -std=c++17",     "file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$",     "working_dir": "${file_path}",     "selector": "source.c, source.c++",     "variants": [         {             "name": "Run",             "shell_cmd": "g++ "${file}" -o "${file_base_name}" -Wall -g -std=c++17 && "${file_path}"${file_base_name}""         },         {             "name": "Run (Console)",             "shell_cmd": "start cmd /k "g++ "${file}" -o "${file_base_name}" -Wall -g -std=c++17 && "${file_path}\"${file_base_name}" & pause""         }     ] }
```
- 解释一下：
  - ```
  "shell_cmd"
```
  ：这是默认的编译命令。
  g++
  是编译器，
```
  "${file}"
```
  代表当前打开的文件路径，
```
  -o "${file_base_name}"
```
  指定输出可执行文件的名称（与源文件同名），
  -Wall
  开启所有警告，
  -g
  生成调试信息，
```
  -std=c++17
```
  指定C++17标准。你可以根据需要改成
```
  c++11
```
  或
```
  c++20
```
  。
- ```
"file_regex"
```
    ：用于捕获编译错误和警告的正则表达式，让Sublime Text能点击跳转到错误行。
  - ```
  "working_dir"
```
  ：指定编译时的当前工作目录，这里是当前文件所在的目录。
- ```
"selector"
```
    ：告诉Sublime Text这个构建系统适用于C和C++文件。
  - ```
  "variants"
```
  ：这是个好东西，它允许你在一个构建系统中定义多个操作。
  - "Run"
    ：编译并直接在Sublime Text的输出面板运行程序。
  - "Run (Console)"
    ：这个是我个人觉得最实用的。它会打开一个新的命令提示符窗口来运行你的程序，这样你就能进行交互式输入了。
    start cmd /k
    就是这个作用，
    & pause
    则让窗口在程序结束后暂停，方便查看输出。
保存构建系统： 将文件保存为
```
C++.sublime-build
```
（或者你喜欢的任何名称，但后缀必须是
```
.sublime-build
```
），Sublime Text会自动把它放到正确的位置。
选择构建系统：
- 打开一个C++源文件（
```
.cpp
```
  ）。
- 点击
```
Tools
```
  ->
```
Build System
```
  ，然后选择你刚刚保存的
```
C++
```
  （或你命名的那个）。
- 现在，你可以按
```
Ctrl+B
```
  (Windows/linux) 或
```
Cmd+B
```
  (macOS) 来编译和运行你的代码了。如果你想使用
```
Run
```
  或
  Run (Console)
  ，可以按
```
Ctrl+Shift+B
```
  来选择。

第三步：安装Sublime Text插件（提升体验）

虽然不是必需，但一些插件能极大提升开发效率。

Package Control： 这是Sublime Text的“应用商店”，你必须先安装它。
- 打开Sublime Text，按
```
Ctrl+
```
  (反引号) 或
```
View
```
  ->
```
Show Console
```
  。
- 在弹出的控制台底部输入框中粘贴Package Control官网提供的安装代码（搜索“Sublime Text Package Control Install”很容易找到）。
- 回车，等待安装完成，可能需要重启Sublime Text。
安装常用插件：
- 按
  Ctrl+Shift+P
  ，输入
```
Package Control: Install Package
```
  ，回车。
- 在弹出的列表中搜索并安装：
  - C++ Extended / Cpptools： 增强C++语法高亮和代码补全。
  - Terminus： 在Sublime Text内部提供一个功能完整的终端。这比Sublime Text自带的输出面板强大多了，你可以直接在里面执行命令、运行程序，甚至进行简单的调试。
  - LSP (Language Server Protocol) + LSP-clangd： 如果你追求更高级的代码智能提示、错误检查和重构功能，LSP是未来的方向。安装LSP插件后，再安装
    LSP-clangd
    ，它会调用Clangd（一个C++语言服务器）提供强大的ide级功能。这需要你的系统也安装了Clang/LLVM，配置起来会比MinGW稍微复杂一点，但效果惊艳。

为什么Sublime Text不如IDE那样“开箱即用”？它的优势又在哪里？

说实话，Sublime Text在C++开发上，确实不如那些全功能的IDE（比如visual studio、CLion、VS Code配置好插件后）来得“开箱即用”。你得自己折腾编译器，自己配构建系统，甚至调试功能也得靠“曲线救国”。这主要是因为Sublime Text的定位就是一个纯粹的、高性能的文本编辑器。它不自带编译器、不自带调试器，它只负责帮你优雅地编辑代码。

但正因为这种“不完美”，也铸就了它的独特优势，这也是我至今仍爱用它的原因：

极致的轻量与速度： 启动飞快，几乎不占用系统资源。无论你的项目多大，文件打开和切换都行云流水。对于我这种经常需要快速打开几个文件修改一下的人来说，这是效率的保证。IDE启动慢，资源占用高，有时候会让人烦躁。
高度的可定制性： 几乎所有的功能都可以通过插件和配置文件来调整。你可以把Sublime Text打造成完全符合你个人工作流的工具。这种掌控感是很多“大而全”的IDE无法比拟的。每次成功配置好一个新功能，那种成就感也挺棒的。
极简的界面： 默认情况下，Sublime Text的界面非常简洁，几乎没有多余的按钮和面板。这让你能更专注于代码本身，减少视觉干扰。当需要某个功能时，
```
Ctrl+Shift+P
```
一键呼出命令面板，效率极高。
多平台支持： Windows、macOS、Linux，在任何系统上，你都能获得一致的体验。
“Geek”精神的体现： 坦白讲，配置Sublime Text的过程本身就是一种学习。你会更深入地理解编译、链接、环境变量这些底层概念，这对于一个程序员来说，是很有价值的。它让你成为工具的主人，而不是被工具束缚。

所以，如果你追求的是快速、灵活、高度定制化的开发体验，并且不介意花一点时间去“折腾”你的工具，Sublime Text绝对是一个值得投入的选择。但如果你更看重一站式、无脑式的开发体验，那也许现代IDE会更适合你。

Build AI

为您的业务构建自己的ai应用程序。不需要任何技术技能。

查看详情

如何在Sublime Text中进行C++代码调试？

说实话，C++代码调试是Sublime Text的弱项，它不像VS Code或专业IDE那样拥有内置的、用户友好的图形化调试界面。Sublime Text本身没有调试器，它需要借助外部调试器（如GDB或LLDB）来完成。所以，在Sublime Text中进行调试，通常会显得比较“原始”，或者需要借助一些插件来模拟。

这里提供几种思路：

利用Terminus插件和外部GDB/LLDB (推荐，但原始)：
- 这是最直接也最可靠的方法。首先确保你已经安装了MinGW（其中包含GDB）或者在Linux/macos上安装了GDB/LLDB。
- 在Sublime Text中安装
```
Terminus
```
  插件。
- 编译你的C++代码时，确保加入了调试信息标志，比如
```
g++ your_code.cpp -o your_program -g
```
  。我上面提供的构建系统配置里就包含了
  -g
  。
- 打开你的C++文件，按
  Ctrl+Shift+P
  ，输入
```
Terminus: Open default Shell
```
  ，这会在Sublime Text底部打开一个终端。
- 在Terminus中，切换到你的代码所在目录（如果不在，用
```
cd
```
  命令）。
- 输入
```
gdb your_program
```
  （Windows下可能是
```
gdb your_program.exe
```
  ）。
- 现在你就可以使用GDB的命令行命令进行调试了：
  - ```
  b main
```
  或
```
  b your_file.cpp:line_number
```
  ：设置断点。
- Run
  ：运行程序。
- ```
n
```
    (next)：单步执行（不进入函数）。
  - ```
  s
```
  (step)：单步进入函数。
- ```
p variable_name
```
    ：打印变量值。
  - ```
  c
```
  (continue)：继续执行到下一个断点。
- ```
q
```
    (quit)：退出GDB。
- 这种方式虽然是纯命令行，但非常强大，让你对调试过程有完全的掌控。
SublimeGDB 插件 (尝试性方案)：
- 这是一个尝试将GDB集成到Sublime Text的插件。它提供了一个简单的界面来设置断点、查看变量等。
- 安装方法：通过Package Control搜索并安装
```
SublimeGDB
```
  。
- 配置：你需要告诉SublimeGDB你的GDB路径，以及如何编译和运行你的程序。这通常涉及修改插件的配置文件。
- 我的经验是： SublimeGDB的配置相对复杂，且不如VS Code的调试器稳定和功能丰富。对于简单项目可能还可以，但遇到复杂的多文件项目，或者需要更高级的调试功能（如条件断点、多线程调试），它可能会力不从心。我个人很少用它，更多时候还是直接用Terminus里的GDB命令行。
LSP + DAP (Debug Adapter Protocol) (进阶，依赖于语言服务器)：
- 如果你已经安装了LSP和
```
LSP-clangd
```
  ，并且你的语言服务器（
```
clangd
```
  ）支持DAP，理论上可以通过LSP插件来集成调试功能。
- 这通常需要安装一个额外的DAP客户端插件，并进行一系列复杂的配置，包括
```
launch.JSon
```
  文件，类似于VS Code。
- 现状： 尽管DAP是未来趋势，但在Sublime Text中，C++的DAP支持还不如VS Code那样成熟和开箱即用。配置起来需要对DAP和语言服务器有较深的理解。

总的来说，对于C++调试，Sublime Text的最佳实践是利用其强大的终端插件（如Terminus）与外部调试器（GDB/LLDB）结合使用。如果你需要一个图形化的、功能完善的调试器，我通常会建议你考虑使用VS Code或专业的IDE，因为它们在这方面做得更好，可以节省你大量的配置时间。Sublime Text的优势在于编辑和构建，而非调试。

配置过程中可能遇到的常见问题及解决方案？

在Sublime Text中配置C++开发环境，虽然不复杂，但总有些小坑等着你。我把一些我经常遇到或者被问到的问题整理一下，希望能帮你少走弯路。

g++

命令找不到，或者Build System报错“command not found”：
- 问题原因： 这是最常见的问题，几乎百分之九十的情况都是因为MinGW的
  bin
  目录没有正确添加到系统环境变量
  Path
  中，或者添加后没有生效。
- 解决方案：
  - 仔细检查
    
    Path
    
    变量： 确保你添加的路径是MinGW安装目录下的
    bin
    文件夹，例如
    C:MinGWmingw64in
    ，而不是MinGW的根目录。路径中不能有错别字。
  - 重启Sublime Text和命令提示符： 有时候环境变量的更改需要重启应用程序才能生效。最保险的方法是重启电脑，但通常重启Sublime Text和打开一个新的
    cmd
    窗口就够了。
  - 验证： 打开一个新的
    cmd
    窗口，输入
    g++ -v
    。如果能显示版本信息，说明PATH是OK的。
  - 多个MinGW版本冲突： 如果你电脑上装了多个MinGW或GCC版本，
    Path
    中靠前的那个会优先被使用。确保你想要使用的版本路径在
    Path
    中靠前。
C++程序运行后，控制台中文乱码：
- 问题原因： 编码不一致。你的源代码文件可能是UTF-8编码，但Windows的命令提示符默认可能使用GBK编码。
- 解决方案：
  - 保存文件时指定UTF-8： 在Sublime Text中，确保你的C++文件以UTF-8编码保存。
```
File
```
    ->
```
Save with Encoding
```
    ->
```
UTF-8
```
    。
  - 在Build System中指定编码： 尝试在你的
    .sublime-build
    文件中添加
```
"encoding": "utf-8"
```
    ，但这主要影响Sublime Text内部的输出面板，对外部
    cmd
    窗口可能无效。
  - 修改
    
    Run (Console)
    
    命令： 最有效的方法是让
    cmd
    窗口在启动时就使用UTF-8。将
    Run (Console)
    的
    shell_cmd
    修改为：
```
"shell_cmd": "start cmd /k "chcp 65001 && g++ "${file}" -o "${file_base_name}" -Wall -g -std=c++17 && "${file_path}\"${file_base_name}" & pause""
```
```
chcp 65001
```
    就是将
    cmd
    的编码设置为UTF-8。
编译失败，但Sublime Text的输出面板没有显示具体的错误信息，或者信息不完整：
- 问题原因： 可能是你的
  g++
  命令没有完全捕获所有错误和警告，或者
```
file_regex
```
  不够完善。
- 解决方案：
  - 添加更多编译选项： 确保你的
    shell_cmd
    中包含
    -Wall
    （显示所有警告）和
    -g
    （生成调试信息）。有时候，一个警告可能就是导致程序行为异常的原因。
  - 手动在Terminus中编译： 如果Sublime Text的输出面板信息不足，你可以尝试在Terminus插件中手动运行
```
g++ your_file.cpp -o your_program -Wall -g
```
    。这样，你可以看到编译器输出的所有原始信息，这通常能帮你定位问题。
  - 检查代码本身： 最常见的原因还是代码本身的语法错误、头文件路径问题或链接错误。
多文件项目如何编译？
- 问题原因： 默认的Build System只编译当前打开的单个文件。对于包含多个
```
.cpp
```
  源文件的项目，这就不够用了。
- 解决方案：
  - 修改Build System命令： 如果项目文件不多，你可以修改
    shell_cmd
    来同时编译所有源文件。例如，在一个包含
```
main.cpp
```
    和
```
utils.cpp
```
    的项目中：
```
"shell_cmd": "g++ main.cpp utils.cpp -o my_project -Wall -g -std=c++17", "working_dir": "${project_path}", // 注意这里改为项目路径
```
    但这需要你手动列出所有源文件，很不灵活。
  - 使用Makefile (推荐)： 这是管理C++多文件项目最专业和灵活的方式。
    - 在你的项目根目录创建一个
      Makefile
      文件。
    - 在
      Makefile
      中定义编译规则。
    - 然后，你的Build System可以简化为：
      { "cmd": ["make"], // 或者 "cmd": ["mingw32-make"] 如果你用MinGW "working_dir": "${project_path}", "selector": "source.c, source.c++" }
    - 这样，Sublime Text只需要调用
      make
      命令，而
      make
      会根据
      Makefile
      来处理所有文件的编译和链接。学习
      Makefile
      是值得的。
Sublime Text插件安装失败或不工作：
- 问题原因： 网络问题（Package Control

评论（已关闭）

评论已关闭

Hello! 欢迎来到悠悠畅享网！