Visual Studio Code中CMake构建-j选项的控制与修改方法

1. 控制-j参数添加的配置项 #

• 核心控制项是VS Code CMake插件的**cmake.build.parallelJobs**设置，插件默认会自动检测系统核心数，将<#cores>替换为检测到的数值，从而生成-j <#cores>参数。
• 另外系统环境变量CMAKE_BUILD_PARALLEL_LEVEL会覆盖插件的自动检测值，如果该变量已设置，插件会直接使用变量值作为-j的参数。

2. 禁用或覆盖-j参数的最佳方式 #

方式一：修改插件全局/工作区设置 #

打开VS Code设置（快捷键Ctrl+,），搜索cmake.build.parallelJobs：

• 要禁用并行构建，直接将值设为1，构建命令会变为-j 1，即单线程运行。
• 要自定义并行数量，填入你需要的核心数（比如4），插件会自动替换<#cores>为该数值。

方式二：自定义构建任务完全移除-j参数 #

如果需要彻底去掉-j参数，可通过自定义tasks.json覆盖默认构建逻辑：

1. 打开命令面板（Ctrl+Shift+P），输入Tasks: Configure Task并选择CMake: Build。
2. 在生成的tasks.json中，修改args字段，删除包含-j的相关配置，示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cmake",
            "label": "CMake: Build",
            "command": "build",
            "targets": ["all"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": [],
            "detail": "CMake template build task",
            "args": [
                "--config", "${config}",
                "--target", "${target}"
            ]
        }
    ]
}

之后执行构建时就不会带上-j参数了。

方式三：临时用环境变量覆盖 #

在VS Code的终端中临时设置环境变量，仅对当前终端会话生效：

export CMAKE_BUILD_PARALLEL_LEVEL=1

执行构建命令时会使用该变量指定的并行数，关闭终端后恢复默认设置。

内容的提问来源于stack exchange，提问作者Chuu