VSCode安装配置与开发调试（详细教程）

VSCode安装配置与开发调试（详细教程）

引用

CSDN

1.

https://blog.csdn.net/m0_37383484/article/details/146114460

Visual Studio Code（简称VS Code）是一款由微软开发的轻量级但功能强大的源代码编辑器，支持几乎所有主流的开发语言。它不仅拥有丰富的插件生态系统，还集成了Git版本控制、调试工具等多种开发工具，能够满足从初级到高级开发者的各种需求。本文将详细介绍VS Code的安装配置与开发调试，帮助你快速上手并充分利用这款强大的开发工具。

一、VS Code基础介绍

1. 安装与配置

1.1 下载和安装 VS Code

1. 打开浏览器，访问 VS Code 官方网站。
2. 根据您的操作系统（Windows、macOS 或 Linux）选择对应的下载按钮。例如，Windows 用户会看到一个蓝色按钮写着“Download for Windows”。
3. 下载完成后，双击安装包（例如 VSCodeSetup.exe），按提示点击“下一步”，安装过程非常简单，默认设置即可完成。

提示：安装时可以选择“添加到 PATH”，这样您就能在命令行中直接输入 code 打开 VS Code。

1.2 安装 C/C++ 插件

1. 打开 VS Code，在左侧活动栏找到“扩展”（Extensions）图标（像一个方块拼图），或者按快捷键 Ctrl+Shift+X。
2. 在顶部搜索栏输入“C/C++”，找到由 Microsoft 开发的“C/C++”插件（通常是第一个）。
3. 点击右侧的“Install”（安装）按钮，等待几秒钟安装完成。

安装 C/C++ 插件

1.3 安装编译工具链

根据您的操作系统，安装对应的工具链以便编译和调试代码：

• Windows：

  1. 下载 MinGW 或 MSYS2。
  2. 安装后，将 MinGW 的 bin 文件夹（例如 C:\MinGW\bin）添加到系统环境变量“Path”中：

• 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。

• 在“系统变量”中找到“Path”，点击“编辑”，添加 MinGW 的 bin 路径。

  3. 验证：打开命令提示符，输入 gcc --version，看到版本号即为成功。

• macOS：

  1. 打开终端，输入 xcode-select --install，按提示安装 Xcode 命令行工具。
  2. 验证：输入 gcc --version 检查。

• Linux：

  1. 打开终端，例如在Ubuntu上运行安装 GCC 和 GDB：
     sudo apt-get install build-essential gdb
  2. 验证：输入 gcc --version 和 gdb --version。

• 配置工具链：

• 确保GCC和GDB在系统路径中可用。如果命令未识别，检查环境变量配置。

2. 界面和基本操作

2.1 界面介绍：

• 文件资源管理器：左侧面板，用于浏览项目中的文件和文件夹。
• 编辑区：中央区域，用于编写和查看代码。
• 终端：底部面板，可运行命令行指令。
• 调试区：左侧活动栏的“调试”图标，用于调试代码。

VS Code 界面

2.2 基本操作：

• 打开文件：按 Ctrl+O，选择文件；或在文件资源管理器中双击。
• 切换标签页：按 Ctrl+Tab 在打开的文件间切换。
• 文件搜索：按 Ctrl+P，输入文件名快速定位。
• 代码跳转：按 F12 跳转到函数或变量定义；按 Ctrl+Shift+O 查找当前文件中的符号。

二、VS Code的个性化设置

1. 主题和外观

1.1 选择主题：

1. 按 Ctrl+K Ctrl+T 打开主题选择器。
2. 尝试推荐主题：Dark+（默认深色）或Light+（默认浅色），选择你喜欢的样式。

选择主题

1.2 调整字体和字号：

1. 按 Ctrl+, 打开设置界面。
2. 搜索“Font Family”（推荐“Consolas”或“Fira Code”），并设置“Font Size”（如14）。

2. 配置文件

• settings.json：

• 按 Ctrl+, 打开设置，点击右上角的“{}”图标，进入 settings.json。

• 示例配置：

  {  
      "editor.fontSize": 14,  
      "editor.tabSize": 4,  
      "editor.minimap.enabled": false  
  }  
  

• fontSize：设置字体大小。

• tabSize：设置 Tab 键的缩进宽度。

• 禁用迷你地图、设置缩进等都可以在这里调整。

• tasks.json：

• 用于构建任务的配置，后续“编译和调试”部分会详细介绍。

3. 快捷键

• 常用快捷键：
• Ctrl+S：保存文件。
• Ctrl+Shift+P：打开命令面板（几乎可以控制VS Code的所有功能）。
• Ctrl+B：显示/隐藏左侧面板。
• Ctrl+Shift+E：聚焦文件资源管理器。
• Ctrl+Shift+F：全局搜索代码。

三、插件的使用

1. 推荐插件

• C/C++：提供代码补全、语法检查等C/C++支持。
• CodeLLDB：强大的调试插件，支持LLDB调试器。
• GitLens：增强Git功能，显示代码提交历史。
• PlatformIO：嵌入式开发利器，支持多种开发板。

2. 插件安装和配置

• 安装插件：

• 按 Ctrl+Shift+X 打开扩展市场。

• 搜索插件名称，点击“Install”安装。

• 配置插件：

• 以C/C++插件为例，在 settings.json 中设置编译器路径：

  {  
      "C_Cpp.default.compilerPath": "/usr/bin/gcc"  
  }  
  

• 其他插件的配置可在扩展文档中查找。

四、代码管理和版本控制

1. Git集成

• 初始化Git仓库：
• 打开项目文件夹，点击左侧“Source Control”图标（或按 Ctrl+Shift+G）。
• 点击“Initialize Repository”按钮。

Git 初始化

• 常用Git操作：
• Commit：输入提交信息，点击“Commit”按钮。
• Branch：点击底部状态栏分支名称（如“master”），选择“Create new branch”。
• Merge：点击“...” -> “Branch” -> “Merge Branch”。
• Rebase：点击“...” -> “Branch” -> “Rebase Branch”。

2. 远程开发

详情可参考：
VS Code远程开发调试教程

• 安装插件：
• 安装“Remote - SSH”和“Remote - Containers”插件。

• 配置远程连接：
• 按 Ctrl+Shift+P，输入“Remote-SSH: Connect to Host”。
• 添加SSH主机（需提前配置SSH密钥），连接后即可在远程服务器上开发。

五、编译和调试

1. 任务和构建系统

• 配置tasks.json：
  Tips
  tasks.json 用于配置任务，通常是自动化执行某些常见的开发任务，比如编译、打包、清理、运行脚本等。

1. 按 Ctrl+Shift+P，输入“Tasks: Configure Task”。
2. 选择“Create tasks.json file from template” -> “Others”。
3. 编辑 tasks.json：
4. 按 Ctrl+Shift+B 运行构建任务。

{  
    "version":"2.0.0",  
    "tasks":[  
        {  
            "label":"build",  
            "type":"shell",  
            "command":"gcc",  
            "args":["-g","${file}","-o","${fileDirname}/${fileBasenameNoExtension}.exe"],  
            "group":{  
                "kind":"build",  
                "isDefault":true  
            }  
        }  
    ]  
}  

常见配置项：

1. label: 任务的名字，可以在命令面板或快捷键中调用。
2. type: 指定任务的类型，通常是 shell（执行 shell 命令）或 process（执行程序）。
3. command: 需要执行的命令。
4. args: 命令的参数。
5. group: 任务分组，例如 build 或 test。
6. problemMatcher: 用于匹配任务输出中的错误或警告信息，支持代码跳转。

2. 调试配置

2.1 配置launch.json：
Tips
用于配置调试设置，帮助 VS Code 在调试时启动应用程序或附加到正在运行的进程。你可以指定如何启动程序，如何传递参数，如何设置断点等。

1. 点击左侧调试图标，点击“create a launch.json file” -> “C++ (GDB/LLDB)”。
2. 编辑 launch.json：

{  
    "version":"0.2.0",  
    "configurations":[  
        {  
            "name":"Debug",  
            "type":"cppdbg",  
            "request":"launch",  
            "program":"${fileDirname}/${fileBasenameNoExtension}.exe",  
            "args":[],  
            "cwd":"${workspaceFolder}",  
            "MIMode":"gdb",  
            "preLaunchTask":"build"  
        }  
    ]  
}  

常见配置项：

• type: 调试类型，常见的有 cppdbg（C/C++ 调试）、node（Node.js 调试）、python（Python 调试）等。
• request: 配置请求的类型，通常是 launch（启动调试）或 attach（附加到正在运行的进程）。
• program: 要调试的程序文件路径。
• args: 传递给程序的命令行参数。
• stopAtEntry: 是否在程序入口处停下来（用于调试时的初始断点）。
• preLaunchTask: 启动调试之前运行的任务（比如编译任务）。

2.2 调试操作：

• 设置断点：点击代码行号左侧。
• 启动调试：按 F5。
• 单步执行：F10（步过）、F11（步入）。
• 观察变量：在调试面板的 “Variables” 查看。

六、高级功能

1. 多文件开发

• 打开多个文件：按 Ctrl+P 搜索并打开文件，使用 Ctrl+Tab 切换。
• 工作区管理：按 Ctrl+Shift+P，输入“Workspaces: Save Workspace As...”保存工作区。

2. 代码片段和模板

• 自定义代码片段：
• 按 Ctrl+Shift+P，输入“Snippets: Configure User Snippets”。
• 选择语言，编辑 snippets.json：

{  
    "Print": {  
        "prefix": "log",  
        "body": ["printf(\"$1\\n\");", "$2"],  
        "description": "Quick printf"  
    }  
}  

3. 远程开发与调试

• 在远程服务器上安装GDB server，配置 launch.json 连接远程调试。

详情可参考：
VS Code远程gdb server调试教程

七、优化开发体验

1. 任务自动化与集成

• 集成Makefile：
• 编辑 tasks.json：

{  
    "label": "make",  
    "type": "shell",  
    "command": "make",  
    "group": {"kind": "build", "isDefault": true}  
}  

• 集成CMake：
• 安装“CMake Tools”插件，配置CMake项目。

2. 性能优化

• 避免打开大型无关文件夹，使用 .gitignore 排除不必要文件。

3. 代码质量工具

• 安装“Cppcheck”进行静态分析，安装“Google Test”支持单元测试。

八、常见问题解决

1. 调试与错误排查

• 无法启动调试：检查 launch.json 中的 program 路径是否正确。
• 断点无效：确保编译时加 -g 标志生成调试信息。
• 插件不工作：确认插件已启用，可能需重启VS Code。
• 远程连接失败：检查SSH配置和网络状态。