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

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

引用

CSDN

1.

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

一、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 installbuild-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配置和网络状态。