CMAKE_EXPORT_COMPILE_COMMANDS

在 3.5 版本中添加。

启用/禁用在生成期间输出编译命令。

如果启用,则生成一个 compile_commands.json 文件,其中包含项目中所有翻译单元的精确编译器调用,格式为机器可读。JSON 文件的格式如下所示

[
  {
    "directory": "/home/user/development/project",
    "command": "/usr/bin/c++ ... -c ../foo/foo.cc",
    "file": "../foo/foo.cc",
    "output": "../foo.dir/foo.cc.o"
  },

  ...

  {
    "directory": "/home/user/development/project",
    "command": "/usr/bin/c++ ... -c ../foo/bar.cc",
    "file": "../foo/bar.cc",
    "output": "../foo.dir/bar.cc.o"
  }
]

这由 CMAKE_EXPORT_COMPILE_COMMANDS 环境变量初始化,并为所有目标初始化 EXPORT_COMPILE_COMMANDS 目标属性。

注意

此选项仅由 Makefile 生成器Ninja 生成器 实现。在其他生成器上会被忽略。

此选项目前与 UNITY_BUILD 目标属性或 CMAKE_UNITY_BUILD 变量结合使用时效果不佳。