admin 管理员组

文章数量: 887021

1 系统环境

  • (1)Windows 7旗舰版。
  • (2)编译环境:msys2 和 mingw。关于msys2 和 mingw的安装配置说明,请参考我的另一篇文章《Windows 7下使用GNU工具编译C/C++程序的环境搭建》。
  • (3)Sublime Text 3最新版本:Build3126。对于其安装,使用请自行百度或者google之,网上介绍非常多;也可参考其官网。

2 Sublime Text 3 编译系统

  • sublime text 3提供了构建功能,它的构建系统(Build systems)可以运行一段外部命令,还可以捕获输出并显示。要在sublime text 3中实现c或c++代码的编译和运行,在本质上说也是调用外部的命令,windows中也可以理解为执行一段cmd命令。
  • 目前c/c++编译器最流行的就是gcc和g++,本文将先详细介绍sublime中自带的编译配置文件,分析每一行的作用。然后给出win7 64bit下 Sublime Text 3 build 3126版本中编译c语言、c++的build配置文件。
  • 另外,文章最后还介绍了sublime中使用make的内容,以及讨论关于中文编码的问题。如果你只想快速配置好编译环境,而对实现细节并不关心(不建议),你可以只阅读配置配置文件详解和编写自己的编译配置文件这几节。

3 Sublime Text 3默认c/c++编译配置文件详解

  • 在《Windows 7下使用GNU工具编译C/C++程序的环境搭建》这篇文章中我们已经介绍了mingw-64工具链的安装。需要注意的是,在sublime text 3 build 3126中,环境变量的修改不会立即在sublime中生效,需要重启windows。

3.1 cmd编译运行c语言

  • 首先,我们要在cmd中进入.c文件所在的目录作为工作目录;也可以在源文件所在目录,按住shift键,然后右击,选择在此处打开命令窗口
  • 然后,执行gcc source.c -o dest来生成可执行文件;
  • 最后,输入生成的可执行文件名来运行生成的程序。

建议大家加入-Wall选项,打开常用的警告。

下面是几种常用的命令:

编译c语言

gcc -Wall 源文件名 -o 可执行文件名

编译c++语言

g++ -Wall 源文件名 -o 可执行文件名

调试c++

g++ -g 源文件名 -o 可执行文件名
gdb 可执行文件名

3.2 介绍默认C/C++编译配置文件

把g++加入环境变量后,sublime中默认的编译系统就可以正常使用了。

Sublime Text 3 3080版本之后修改了编译系统,具体设置是

Ctrl+B 执行改格式上次的编译命令:

如果第一次执行则提示选择执行哪个Ctrl+Shift+B 选择执行哪个:

不足之处:

  • 程序输出捕获到Sublime窗口中,这样导致不能运行时输入信息。执行含有scanf语句的代码会卡住。
  • 默认情况下c和c++没有进行区分,全部当做c++格式来处理了。

解决办法:

  • 第一个是设置在新的cmd窗口执行程序,这样就可以输入信息。
  • 第二个是针对c语言单独写一个build配置文件。

默认的编译配置文件位置:

在Sublime的安装目录的Packages文件夹中,有个文件叫C++.sublime-package:

这个实际上是zip的压缩包,里面包含了c++的默认系统设置,修改后缀名为zip后解压,可以在里面找到C++ Single File.sublime-build文件。
这个文件名就是上面要编译时可以选择的名字,

编译配置文件详解

文件内容如下:

{
    "shell_cmd": "g++ \"${file}\" -o \"${file_path}/${file_base_name}\"",
    "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$",
    "working_dir": "${file_path}",
    "selector": "source.c, source.c++",

    "variants":
    [
        {
            "name": "Run",
            "shell_cmd": "g++ \"${file}\" -o \"${file_path}/${file_base_name}\" && \"${file_path}/${file_base_name}\""
        }
    ]
}

这个JSON格式的配置文件就是sublime中build文件的真面目了。花括号里面是一个个的键值对,它们之间用逗号隔开。键和值中间是一个冒号。为了方便下面把键称为名称。
名称和值都要用双引号括起来,因此值里面用到双引号的话,就要用转义 \” (反斜杠+双引号)表示。
这里面用到的名称的含义如下:

  • working_dir:运行cmd是会先切换到working_dir指定的工作目录
  • cmd:包括命令及其参数。如果不指定绝对路径,外部程序会在你系统的:const:PATH 环境变量中搜索。
  • shell_cmd :相当于shell:true的cmd ,cmd可以通过shell运行
  • file_regex:该选项用Perl的正则表达式来捕获构建系统的错误输出到sublime的窗口。
  • selector:在选定 Tools | Build System | Automatic 时根据这个自动选择编译系统。
  • variants:用来替代主构建系统的备选。也就是一个配置文件可以对应多个执行命令
  • name:只在variants下面有,设置命令的名称,例如Run。

上面的配置文件中还有一些类似 ${file} 这种符号,这是sublime提供的变量,一些常用的变量如下:

  • $file_path:当前文件所在目录路径, e.g., C:\Files.
  • $file:当前文件的详细路径, e.g., C:\Files\Chapter1.txt.
  • $file_name:文件全名(含扩展名), e.g., Chapter1.txt.
  • $file_extension:当前文件扩展名, e.g., txt.
  • $file_base_name:当前文件名(不包括扩展名), e.g., Document.

变量的使用可以直接使用,也可以使用花括号括起来,例如 ${project_name}

我们详细看一下这个文件:

"working\_dir": "${file_path}",

这一行说明工作目录,也就是执行命令时所在的目录,被设置为文件所在的目录。

"shell_cmd": "g++ \"${file}\" -o \"${file_path}/${file_base_name}\"",

这就是编译时执行的命令了,它的值的部分是:
执行时,${file}会被替换为编辑的文件名,${file_path}/${file_base_name} 就会被替换为不包含扩展名的完整路径名。它们前后有\”双引号是为了支持带空格的文件名。

假设我们编辑的文件路径为 Z:/cpp/t.cpp ,那么执行时的工作目录就是 Z:/cpp 。${file} 就是 Z:/cpp/t.cpp ,${file_path} 就是 Z:/cpp ,${file_base_name} 就是 t 。我们把转义字符双引号也用双引号表示,这样执行的命令就变成了

g++ "Z:/cpp/t.cpp" -o "Z:/cpp/t"

这正好是编译文件的命令,文件路径前后的双引号保证它支持带空格的路径。编译后生成的可执行文件和源代码文件在一个目录下,名字相同(扩展名不同)。

如果有编译错误,错误信息就会被”file_regex”中的正则表达式匹配并显示。

再来看最后面的代码:

"variants":
    [
        {
            "name": "Run",
            "shell_cmd": "g++ \"${file}\" -o \"${file_path}/${file_base_name}\" && \"${file_path}/${file_base_name}\""
        }
    ]

variants的值是一个数组,可以放很多个对象,每个对象表示一个命令。里面name表示了这个命令的名称为Run,也就是运行。编译时选择C++ Single File-Run就会执行这里面的shell_cmd。
运行部分的命令前半部分和编译一样,后面用 && 连接了另一个命令,&&表示编译成功才执行后面的部分。后面为

\"${file_path}/${file_base_name}\"

也就是直接运行可执行文件了。这样是在sublime中捕获运行结果的。看懂这个默认配置文件后,照葫芦画瓢,我们很容易的就可以写出符合自己需要的配置文件。

但是不建议直接修改这个文件,建议大家把用户配置放到用户文件夹下,来代替默认的编译配置。

4 编写自己的编译配置文件

c语言(Windows 7)

  • 选择tool –> Build System –> New Build System

  • 然后输入以下代码:
{
    "working_dir": "$file_path",
    "cmd": "gcc -Wall \"$file_name\" -o \"$file_base_name\"",
    "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$",
    "selector": "source.c",

    "variants": 
    [
        {   
        "name": "Run",
            "shell_cmd": "gcc -Wall \"$file\" -o \"$file_base_name\" && start cmd /c \"\"${file_path}/${file_base_name}\" & pause\""
        }
    ]
}

和默认相比,就是修改了selector部分为只选择.c文件。Run中的shell_cmd后面部分加上了start cmd /c,start作用是新开一个cmd窗口,cmd表示要执行一个命令行,/c执行完后退出新开的窗口,后面的& pause保证运行结束后窗口不会立即退出。这样Run就会在新的cmd窗口中运行了。

  • 按Ctrl+s保存,会自动打开user目录(Sublime Text 3\Packages\User),我们修改 文件名为 c.sublime-build,保存在此目录。

这时候,可以在Tools -> Build System下看到刚才新建的c了:

选中后就可以使用了。

Build System中除了选择具体的编译系统,还可以选择第一个:Automatic 自动选择,会根据打开的文件后缀自动选择。

c语言(Linux)

请参考我的另一篇文章:
Sublime Text 3直接编译执行C/C++程序

C++

gcc虽然可以编译c++代码,但是不能进行c++的连接函数库操作。所以针对c++代码一般使用g++来编译。
方法和上面的c语言的配置一样,只要把配置文件中的gcc改为g++ ,source.c改为source.c++ ,保存文件名c.sublime-build改为c++.sublime-build就可以了。
这里增加了-std=c++11 选项,是按照C++11标准进行编译,不需要的话可以去掉,配置文件如下:

{
    "encoding": "utf-8",
    "working_dir": "$file_path",
    "shell_cmd": "g++ -Wall -std=c++11 \"$file_name\" -o \"$file_base_name\"",
    "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$",
    "selector": "source.c++",

    "variants": 
    [
        {   
        "name": "Run",
            "shell_cmd": "g++ -Wall -std=c++11 \"$file\" -o \"$file_base_name\" && start cmd /c \"\"${file_path}/${file_base_name}\" & pause\""
        }
    ]
}

实际上,我们可以利用Varians ,来配置多个不同的编译命令。
下面的配置文件有编译 ,编译并在sublime中运行,编译并cmd运行 和 gdb调试 四个命令。
注:gdb调试是打开命令行的方式,这里不支持带空格的源代码文件名和路径,gdb的使用可以参考:gdb调试新手入门(一) | 雅乐网 。 要想通过sublimeGDB插件实现图形化调试,可以参考Sublime Text 3 使用 SublimeGDB 图形化调试c/c++程序。

{
    "encoding": "utf-8",
    "working_dir": "$file_path",
    "shell_cmd": "g++ -Wall -std=c++11 \"$file_name\" -o \"$file_base_name\"",
    "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$",
    "selector": "source.c++",

    "variants": 
    [
        {   
        "name": "Run in sublime",
            "shell_cmd": "g++ -Wall -std=c++11 \"$file_name\" -o \"$file_base_name\" && cmd /c \"${file_path}/${file_base_name}\""
        },
        {   
        "name": "CMD Run",
            "shell_cmd": "g++ -Wall -std=c++11 \"$file\" -o \"$file_base_name\" && start cmd /c \"\"${file_path}/${file_base_name}\" & pause\""
        },
        {   
        "name": "gdb Debug",
            "shell_cmd": "g++ -g -std=c++11 \"$file\" -o \"$file_base_name\" && start cmd /c gdb ${file_path}/${file_base_name} & pause"
        }
    ]
}

5 使用makefile编译多个文件

sublime可以使用makefile来编译多个文件,以便支持稍大一点的工程项目。(windows下面和linux下面并不相同,本文介绍适用于windows)

这个功能只打开单个文件是没有的,只有打开整个文件夹

侧边栏中可以看到打开的文件夹,确保文件夹中包含makefile文件。此时按下Ctrl+Shift+B ,会有make的选项。
这里make选项执行的是make,但是windows中是没有make这个命令的。MinGW\bin里面的名字是mingw32-make.exe 。解决办法是修改这个文件名改为make.exe ,或者自己新建一个makefile的build文件。
makefile的默认编译配置文件在”C:\Program Files\Sublime Text 3\Packages\Makefile.sublime-package”,解压后的Make.sublime-build文件中。
我们新建一个编译系统,tool –> Build System –> New Build System,内容为

{
    "shell_cmd": "mingw32-make",
    "file_regex": "^(..[^:\n]*):([0-9]+):?([0-9]+)?:? (.*)$",
    "working_dir": "${folder:${project_path:${file_path}}}",
    "selector": "source.makefile",
    "syntax": "Packages/Makefile/Make Output.sublime-syntax",
    "keyfiles": ["Makefile", "makefile"],

    "variants":
    [
        {
            "name": "Clean",
            "shell_cmd": "mingw32-make clean"
        },
        {
            "name": "Run",
            "shell_cmd": "mingw32-make run"
        },
    ]
}

保存为mingw32-make.sublime-build,保存位置和上面c++配置文件位置相同就可以了。
然后打开文件夹后,如果里面有Makefile或makefile文件,就会有对应的命令

由于windows下面常用命令和linux不同,makefile也要做对应的修改:
6 makefile示例
下面是一个简单的示例:
现在有一个test文件夹,里面有4个文件

其中main.cpp用到了function.cpp中的函数。具体代码如下:
main.cpp

#include <unistd.h>
#include <ctype.h>
#include <iostream>
#include "function.h"

int main(void)
{
    int a = 3, b = 9;

    std::cout << add(a, b) << std::endl;

    sleep(10);

    return 0;
}

function.h

#ifndef _FUNCTION_H_
#define _FUNCTION_H_

int add(int parm1, int parm2);

#endif /* _FUNCTION_H_ */

function.cpp

#include <ctype.h>

int add(int parm1, int parm2)
{
    return parm1 + parm2;
}

makefile

main: main.cpp function.h function.cpp

clean:
    del main.exe *.o

run:
    mingw32-make && start cmd /c "main.exe & pause"

注意:makefile里面的clean和run,和我们自己的配置文件里的”variants”下面的命令mingw32-make clean和mingw32-make run对应的。

clean下面使用命令为del而不是linux下面的rm。

另外,由于windows下没有cc命令,这里不能出现全部依赖.o文件的目标。例如不能有这样的规则:

main : main.o function.o

使用这样的规则时,会调用cc,但是windows下面cc没法使用,就会报错。

在sublime text 3中打开该文件夹(注意必须打开文件夹,只打开文件没有make选项)

之后使用Ctrl+shift+B 选择对应的mingw32-make命令即可。

Run对应了编译并运行。

关于Makefile的编写,可以参考我的文章:
(1)makefile的语法及写法
(2)Makefile-例程讲解

本文标签: 环境 Windows Sublime text