问小白 wenxiaobai
资讯
历史
科技
环境与自然
成长
游戏
财经
文学与艺术
美食
健康
家居
文化
情感
汽车
三农
军事
旅行
运动
教育
生活
星座命理

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 路径。

    1. 验证:打开命令提示符,输入 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 --versiongdb --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操作

  • 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: 任务分组,例如 buildtest
    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配置和网络状态。
© 2023 北京元石科技有限公司 ◎ 京公网安备 11010802042949号