VS Code配置CMake Tools构建前执行source环境变量脚本

方案一：通过CMake Tools配置预加载环境脚本 #

CMake Tools支持在执行CMake前运行自定义脚本，按以下步骤配置：

1. 打开VS Code设置（快捷键Ctrl+,），搜索cmake.preConfigureCommand，点击编辑 in settings.json
2. 在settings.json中添加配置：

   "cmake.preConfigureCommand": "source ${workspaceFolder}/scripts/env.sh",
   "cmake.configureEnvironment": {
       "SHELL": "/bin/bash"
   }
   

   ${workspaceFolder}会自动映射到项目根目录，确保脚本路径与实际一致。
3. 点击状态栏的"Configure"按钮重新触发CMake配置，此时会先执行环境脚本再运行CMake。

方案二：自定义tasks.json构建任务，完全模拟终端流程 #

如果CMake Tools的配置不生效，直接写自定义构建任务复现终端操作：

1. 在项目.vscode目录下创建/修改tasks.json：

   {
       "version": "2.0.0",
       "tasks": [
           {
               "label": "Build Project",
               "type": "shell",
               "command": "cd ${workspaceFolder} && source scripts/env.sh && cmake . && make -j 10",
               "group": {
                   "kind": "build",
                   "isDefault": true
               },
               "problemMatcher": "$gcc",
               "detail": "先加载环境脚本，再执行cmake和多线程编译"
           }
       ]
   }
   

2. 保存后按Ctrl+Shift+B即可触发默认构建，完全复用你手动执行的流程。

方案三：修改VS Code启动方式，全局加载环境 #

让整个VS Code会话继承环境脚本的配置：

1. 关闭所有VS Code窗口
2. 在终端中执行：

   source /path-to-project-main-folder/scripts/env.sh && code .
   

3. 打开项目后，CMake Tools和C/C++扩展会自动使用终端传递的环境变量，直接使用默认构建即可。

注意事项 #

• 确保env.sh中没有交互式命令（如需要输入确认的步骤），避免构建卡住
• 方案一中指定SHELL为bash是为了兼容source命令，部分系统默认sh不支持该命令
• 方案三的环境仅对当前VS Code会话有效，重新打开需重复操作

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