Fanstasy Player / 幻想系玩家
Fanstasy Player / 幻想系玩家

Vscode开发c++ 介绍

Aincvy
  约 2700 字 预计阅读 6 分钟 
注意
本文最后更新于 2023-07-30，文中内容可能已过时。

笔者也是刚开始使用vs-code， 部分技巧还不是很熟练， 不过感觉没有CLion 那么好用。

笔者是使用Mac版本的 vs code，不过应该都差不多把。

拓展

vscode 本身能做的事情比较少， 还是要借助拓展来实现功能。

配置项

clangd

即llvm-vs-code-extensions.vscode-clangd拓展。

这个插件需要 Cmake 生成一个额外的文件指示编译命令。 可以在CMakeLists.txt文件添加下面这行生成。

1

set(CMAKE_EXPORT_COMPILECOMMANDS ON)

如果提示插件找不到 clangd，可以让插件自动下载一个。

参数可以使用类似下面的内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

"clangd.arguments": [
        "-background-index",
        "--compile-commands-dir=./build",
        "-clang-tidy",
        "-log=verbose",
        "-pretty",
        "-suggest-missing-includes",
        "-header-insertion=iwyu",
        "-completion-style=detailed",
        "--query-driver=/usr/bin/clang++"
    ]

其中--compile-commands-dir=./build 指定了 cmake 的 build文件夹， --query-driver=/usr/bin/clang++ 指定了一个额外的 clang++ 用于查询 include目录。

笔者刚开始使用这个插件的时候， c++的库文件找不到， 提示 'string' file not found/ 'filesystem' file not found等的这类， 但是笔者的项目是可以编译的， 添加了这个query-driver选项之后就好了。

在项目的根目录下， 创建下面文件可以指定一些额外的配置项。

每个人对格式的感觉不一样， 建议手动从头撸一份配置。

这里有一点 笔者要说一下。 clang-format不能处理这种情况。

1
2
3
4
5
6

if (f1.fileType == ProjectFileType::Directory && f2.fileType == ProjectFileType::Regular) {
  return true;
} else if ((f1.fileType == ProjectFileType::Directory && f2.fileType == ProjectFileType::Directory) 
           || (f1.fileType != ProjectFileType::Directory && f2.fileType != ProjectFileType::Directory)) {
  return f1.filename < f2.filename;    
}

第二个else if的条件， 因为条件代码太多， 所以笔者拆成了两行，但是在格式化之后会自动合并到一行，且笔者并没有找到办法处理这个。

当 clangd出现缓存问题的时候，可以考虑下面的方式。

  • cmd/ctrl+shift+p 输入 clangd, 选择 restart language server
  • cmd/ctrl+shift+p 输入 reload window
  • 重启 vs code.

vs-code

vs-code 本身也有一些可以调整的选项。

1
2
3
4
5
6
7

// 自动保存   5s保存一次
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 5000,
// 粘贴之后自动对齐格式
"editor.formatOnPaste": true,
// 使用 代码段等提示的时候 也会产生代码补全
"editor.suggest.snippetsPreventQuickSuggestions": false,

编译和运行

添加配置

如果使用了 Cmake 插件， 这一步可以不做。

左侧工具栏里有一个 编译和运行的按钮，点一下就能看到调试界面了。

点击上方的下拉框之后，选择“添加配置” 或者点击右侧的齿轮按钮应该都能到launch.json文件的编辑界面，只不过点击“添加配置”的时候， 会自动添加一个示例的配置项。

笔者是 Mac 系统下， 使用 lldb 进行调试的，下面给出一下笔者的配置内容，给读者一个参考。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

{
  "name": "(lldb) 启动",
  "type": "cppdbg",
  "request": "launch",
  "program": "${command:cmake.launchTargetPath}",
  "args": [],
  "stopAtEntry": false,
  "cwd": "${workspaceFolder}",
  "environment": [
    {
      // add the directory where our target was built to the PATHs
      // it gets resolved by CMake Tools:
      "name": "PATH",
      "value": "${env:PATH}:${command:cmake.getLaunchTargetDirectory}"
    },
  ],
  "externalConsole": true,
  "MIMode": "lldb"
}

笔者使用了 cmake插件提供的值， 而没有具体指定。

启动和调试

添加了正确的配置项之后， 程序应该就可以在 VS Code 中调试了。

使用 cmake 插件的时候，可以使用下面的方式启动程序。

  • 使用 Ctrl+F5 或者点击底部状态栏的小虫子🐞按钮 打开程序进行调试。
  • 使用Shift+F5 或者点击底部状态栏的播放按钮 ▶正常运行程序。

如果没有使用 cmake 插件的话， 就需要按照上一部分添加配置项。

  • 之后还是在底部状态栏， 可能看到配置项的名字，点一下应该就可以了。

可以在行号左侧点击一下，以添加断点。

在程序碰到致命错误或者断点的时候会暂停执行程序，当程序暂停之后可以在调试界面看到更多信息。

底部还有一个DEBUG CONSOLE ，这是一个调试用控制台，输入变量名用于查看变量的值， 还能执行部分函数。但是好像不支持其他命令。

将鼠标放到对应代码上， 也可以看到当前的值。

这个DEBUG CONSOLE有一个问题， 那就是打印出来的文字并不好看。 每一行基本都是使用@"内容"的形式。 其中内容字符串里面的转义字符并不会被转义，而是直接打印出来。

成功启动调试之后， 会有一个小小的工具栏在VS Code 窗口的中间正上方的位置，可以重启，结束调试，步进，按行执行等。

拓展阅读

总结

有了上面的这些插件之后， 就可以正常工作了。

虽然还是有一些不太严重的不足：

  • switch 不能自动补全缺失的 case 项
    • 似乎是cmantic插件带有的功能， 可以补全缺少的 case 项目。 具体操作是鼠标点击一下 switch 关键字中间的任意位置，之后左侧应该会出现一个蓝色的按钮，点击一下会有一个按钮，再点一下按钮就会补全 case 项了。
    • 但是 补全的列表，只有最后一项有 break，其他项目需要自己手动添加。
    • 如果存在 default关键字，就不会追加缺少的 case项。
  • 代码段的功能不是很好用 (if/for/while之类的)
  • 代码格式化有点蛋疼， 不像 Jetbrains家族的那些， 自带的就很舒服。
    • 如果 clang-format 可以满足读者的需求， 那么可以无视这条。

笔者目前是使用命令行手动make 和run的，所以编译运行相关的功能还没有测试过，不知道是否好用。

总体来说，还是比较满意的。 有部分插件，笔者还没来得及也没有细究。

更新于 2023-07-30 
Released under CC BY-NC 4.0
返回 | 主页
0%