graphengine/scripts/debug.md

# vsCode 开发环境搭建指南
## 安装vsCode扩展
        
>### 安装docker插件   
>在vsCode扩展中心搜索docker，安装docker扩展，安装完成后，会在左侧显示docker的图标，切换至docker，会看到当前创建的docker 的 container 以及 container 下的image列表。
> 
>![docker_image_list](images/docker_image_list.png)
>
>选择一个Image，右键选择 Attach Vidual Studio Code，（如果镜像不在运行状态，右键 start）
>
>![add_vscode_schema](images/add_vscode.png)
>
>### 安装C/C++插件
>
>在vsCode中使用断点进行调试，需要在链接到docker镜像之后重新安装C/C++扩展。
>
>![C_C++_install](images/C_C++_install.png)

## vsCode进行断点调试
>    
>### 配置lanuch.json。
>
>点击菜单栏中的【运行】|【添加配置...】
>
>![first_add_config](images/first_add_config.png)
>    
>弹出下列选择窗口，选择【C++(GDB/LLDB)】，vscode会自动打开lanuch.json：
>
>![C++_select](images/C++_select.png)
> 
>在这里，只需要配置两个参数，一是将【program】参数配置成可调式文件的全路径。第二个是将【name】参数也更改为自己容易区分的名称。   
>如下图，配置了ut_libgraph的调试信息：   
>**注：这里的workspaceFolder（当前打开文件夹的目录）为/code/Turing/graphEngine**
>
>![modify_json](images/modify_json.png)
>    
>vsCode可以添加多个调试文件，点击添加配置，会弹出如下选项列表，选择【C/C++:(gdb)启动】：
>    
>![add_debug_config](images/add_config.png)
>
>依然是更改【program】与【name】两个参数。根据上述方式将需要调试的可执行文件添加到配置文件中。
>完成配置后，在vsCode最左侧，切换到运行和调试，如下所示选择一个自己需要调试的文件进行调试。
>
>![modify_json_complete](images/modify_json_complete.png)
>
>### vsCode 调试示例
>根据调试需要在对应源代码中添加断点，最终调试效果如下：
>
>![debug](images/debug.png)