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

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

---

如果这篇文章对你有帮助，记得点赞👍+ 关注。

关注公众号，获取更多资讯、嵌入式开发技巧和技术干货！🌱