1. VS Code 安装步骤
访问官方网站下载：https://code.visualstudio.com/，根据操作系统选择对应版本：
- Windows：选择
Windows版本，下载.exe安装文件 - macOS：选择
macOS版本，下载.dmg镜像文件 - Linux：根据发行版选择
.deb（Debian/Ubuntu）或.rpm（CentOS/RHEL）版本，或下载.tar.gz压缩包
双击运行下载的 .exe 文件，进入安装向导：
- 勾选
接受许可协议，点击下一步 - 选择安装路径（建议默认路径，或自定义非中文路径）
- 关键步骤：在
选择附加任务中务必勾选：- ✅ 添加到 PATH（方便终端调用
code命令） - ✅ 创建桌面快捷方式
- ✅ 关联文件类型（可选，建议勾选 .cpp/.c 文件）
- ✅ 添加到 PATH（方便终端调用
- 点击
安装，等待安装完成后点击完成
双击下载的 .dmg 文件，将 VS Code 图标拖入 Applications 文件夹；打开 启动台 找到 VS Code 并启动（首次启动可能需要授权，按提示操作即可）。
打开 VS Code：
- 选择主题：点击
颜色主题，推荐Dark+（默认深色）（对眼睛更友好，代码对比度高） - 暂不安装推荐插件，后续按需配置 C 语言相关插件
2. C 语言开发必备插件
打开 VS Code，点击左侧菜单栏的扩展图标（或按快捷键 Ctrl+Shift+X），在搜索框中输入插件名称，找到对应插件后点击 安装。
推荐插件
| 插件名称 | 开发者 | 核心功能 |
|---|---|---|
| C/C++ | Microsoft | 官方核心插件，提供 C/C++ 语法高亮、智能提示、代码格式化、调试支持 |
| C/C++ Extension Pack | Microsoft | 插件集合，包含 C/C++、CMake Tools 等，一键安装所有基础工具，避免遗漏 |
| Code Runner | Jun Han | 一键运行代码，支持 C/C++ 等多种语言，无需手动输入编译命令 |
| Doxygen Documentation Generator | Marat Dulin | 生成 Doxygen 文档，方便代码注释和 API 文档生成 |
| vscode-icons | vscode-icons-team | 提供丰富的图标，使文件树更美观，方便识别文件类型 |
| Serial Monitor | Mads Kristensen | 串口调试工具，方便调试嵌入式系统、单片机等 |
| CMake Tools | Microsoft | 自动识别 CMakeLists.txt，提供构建 / 调试一体化支持 |
可选增强插件
- GitLens：增强 Git 集成，显示代码提交历史、作者信息，方便多人协作开发
- Better Comments：优化注释显示，支持按不同类型（警告、TODO、说明）给注释添加颜色标记
3. SSH 远程连接配置（远程开发 C 语言）
在扩展商店搜索 Remote - SSH（由 Microsoft 开发），点击 安装。安装完成后，左侧菜单栏会新增 远程资源管理器 图标（类似显示器的图标）。
点击左侧 远程资源管理器 图标，在 SSH Targets 下方点击 配置 图标（齿轮形状），选择 SSH 配置文件路径：
- Windows：
C:\Users\你的用户名\.ssh\config - macOS/Linux：
~/.ssh/config（若不存在则自动创建）
在配置文件中添加远程服务器信息（按实际情况修改），保存（Ctrl+S）：
# 自定义主机名（方便记忆，如 linux-server）
Host linux-server
# 远程服务器的 IP 地址或域名
HostName 192.168.1.100
# 登录用户名（一定是实际定义的用户名，不一定是 ubuntu）
User ubuntu
# SSH 端口（默认 22，修改过则填实际端口）
Port 22在 远程资源管理器 的 SSH Targets 列表中找到刚才配置的主机名，右键点击并选择：
Connect to Host in Current Window：当前窗口连接（关闭本地项目）Connect to Host in New Window：新窗口连接（保留本地项目，推荐）
首次连接会提示 选择平台，根据远程系统选择（如 Linux）；输入远程服务器的登录密码（输入时终端不显示字符，输完按回车即可）；若提示 是否信任此主机，输入 yes 回车。连接成功后窗口左下角显示 SSH: 主机名。
远程服务器配置 C 语言环境
连接成功后，VS Code 会显示 远程 标识（窗口左下角有 SSH: 主机名）。此时需在远程服务器安装 C 语言编译器：
可以把本地安装的插件都在远程服务器上安装一遍，这样就可以在本地和远程服务器之间切换了
打开 VS Code 内置终端（Ctrl+`），执行（gcc 是 C 编译器，g++ 是 C++ 编译器，gdb 是调试工具）：
sudo apt update && sudo apt install -y gcc g++ gdb执行：
sudo yum install -y gcc gcc-c++ gdb执行 gcc --version，若显示版本信息（如 gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0），则说明安装成功。
gcc --version4. 连接 WSL
先安装 WSL，参考：WSL 安装教程
再安装 Ubuntu 发行版，参考：Ubuntu 安装教程——WSL 安装章节
在扩展商店搜索 WSL（由 Microsoft 开发），点击 安装。安装完成后，左侧菜单栏会新增 远程资源管理器 图标。
在 远程资源管理器 的 WSL Targets 列表中找到 WSL 发行版名称（如 Ubuntu-20.04），右键点击发行版名称，选择 在当前窗口连接 或 在新窗口连接。
首次连接 VS Code 会在 WSL 中下载 VS Code Server，请耐心等待安装完成。
常见问题
运行代码提示 “gcc 不是内部或外部命令”（本地 Windows）
未安装 MinGW 或未配置环境变量：下载 MinGW，安装时勾选 mingw32-gcc-g++，把 MinGW 的 bin 目录（如 C:\MinGW\bin）添加到系统 Path 变量，重启 VS Code 再运行。
SSH 连接提示 “Permission denied”（权限拒绝）
确认用户名和密码是否正确（注意大小写）；若服务器禁止密码登录，需配置 SSH 免密登录：本地执行 ssh-keygen -t rsa（一路回车），再执行 ssh-copy-id 用户名@服务器IP 上传公钥，并在 SSH 配置文件中添加 IdentityFile 指向本地私钥路径。
调试时提示 “找不到调试器”
未安装 gdb 调试工具：本地 Windows 在 MinGW 安装时勾选 mingw32-gdb；远程服务器执行 sudo apt install gdb（或 sudo yum install gdb）安装。
遇到问题？
如有其他问题，请到统一的提问与讨论区：Ai-Thinker Discussions