Ubuntu 18.04 虚拟机 VS Code 安装配置指南（嵌入式/C开发适配）

目录

1. 网络连通性检测与配置
2. 更换国内软件源（加速下载）
3. VS Code 安装与启动栏配置
4. 开发必备插件安装
5. VS Code 核心配置（settings.json）
6. 辅助开发工具安装

1. 网络连通性检测与配置

VS Code 安装和插件下载需依赖网络，首先确保虚拟机网络正常。

1.1 检测网络连通性

打开虚拟机终端，执行以下命令测试网络：

ping www.baidu.com

若输出类似以下信息，说明网络正常：

PING www.a.shifen.com (183.2.172.17) 56(84) bytes of data.
64 bytes from 183.2.172.17 (183.2.172.17): icmp_seq=1 ttl=128 time=100 ms
64 bytes from 183.2.172.17 (183.2.172.17): icmp_seq=2 ttl=128 time=35.4 ms

1.2 虚拟机网络配置（Net模式）

若网络不通，按以下步骤配置：

1. 关闭虚拟机，打开虚拟机设置 → 网络适配器；
2. 选择「Net模式」（主机可上网时，虚拟机无需额外配置即可共享网络）；
3. 勾选「已连接」和「启动时连接」，点击确定；
4. 启动虚拟机，终端执行 ifconfig，记录 ens 开头的网卡名（默认通常为 ens33）；
5. 编辑网络配置文件，执行命令：

   sudo vi /etc/network/interfaces
   

6. 输入密码（默认密码 1），进入文件后保留以下两行内容（自动获取IP）：

   auto ens33
   iface ens33 inet dhcp
   

7. 保存退出（Esc → :wq），重启虚拟机生效：

   sudo reboot -f
   

8. 重启后再次执行 ping www.baidu.com，验证网络是否正常。

2. 更换国内软件源（加速下载）

Ubuntu 默认软件源位于国外，下载速度较慢，更换为国内阿里云源可大幅提升效率。

1. 点击 Ubuntu 桌面左上角「开始菜单」，搜索「software」，打开「Software & Updates」；
2. 在「Ubuntu Software」标签页，点击「Download from」下拉菜单；
3. 选择「Other…」，在弹出的列表中找到「China」→「aliyun.com」，点击「Choose Server」；
4. 输入密码（1），点击「Authenticate」；
5. 点击「Close」关闭窗口，此时会提示「The information about available software is out of date」，无需理会；
6. 打开终端，执行以下命令更新软件源缓存：

   sudo apt-get update
   

   等待更新完成（无报错即可）。

3. VS Code 安装与启动栏配置

3.1 安装 VS Code

1. 从钉钉群下载 VS Code 安装包（code_1.85.2-1705561292_amd64.deb）；
2. 将安装包复制到虚拟机的 /home/linux 目录下（可通过共享文件夹或拖拽方式）；
3. 打开终端，切换到 /home/linux 目录：

   cd /home/linux
   

4. 执行以下命令安装 VS Code（dpkg 是 Ubuntu deb 包安装工具）：

   sudo dpkg -i code_1.85.2-1705561292_amd64.deb
   

5. 若终端输出「Setting up code (1.85.2-1705561292) …」，说明安装成功。

3.2 添加 VS Code 到启动栏

1. 点击 Ubuntu 开始菜单，搜索「code」；
2. 右键点击 VS Code 图标，选择「Add to Favorites」；
3. 此时 VS Code 图标会显示在左侧启动栏，后续可直接点击启动；
4. 也可在终端直接输入 code 命令启动 VS Code。

4. 开发必备插件安装

VS Code 需安装对应插件才能支持 C/嵌入式开发，步骤如下：

1. 启动 VS Code，点击左侧边栏「Extensions」（快捷键 Ctrl+Shift+X）；
2. 搜索并安装以下插件（输入插件名，点击「Install」）：
   • C/C++：微软官方插件，提供 C/C++ 语法高亮、智能提示、调试功能；
   • Clangd：替代默认 C/C++ 语言服务器，提供更精准的代码补全和跳转；
   • Code Spell Checker：拼写检查工具，避免变量名/函数名拼写错误；
   • vscode-icons：文件图标美化，不同类型文件显示不同图标，便于识别；
   • Device Tree：嵌入式设备树（.dts/.dtsi）语法高亮和智能提示；
   • CMake：CMake 语法支持，适配嵌入式项目构建；
   • Hex Editor：十六进制编辑器，用于查看二进制文件（如 .o/.bin 文件）；
3. 安装完成后，重启 VS Code 使插件生效。

5. VS Code 核心配置（settings.json）

通过配置 settings.json 优化开发体验，适配 C/嵌入式开发需求：

1. 启动 VS Code，按 Ctrl+, 打开设置；
2. 点击右上角「打开设置(JSON)」，进入 settings.json 编辑界面；
3. 打开钉钉群中的 settings.json 文件，复制全部内容；
4. 将复制的内容粘贴到自己的 settings.json 中，覆盖原有内容；
5. 保存文件（Ctrl+S），重启 VS Code 使配置生效。

说明：配置文件已预设 clangd 路径、代码格式化规则、文件关联等，无需手动修改，若后续调整工具路径，可直接在 JSON 中编辑。

6. 辅助开发工具安装

6.1 安装 clangd（代码补全工具）

1. 从钉钉群下载 clangd-linux-14.0.3.zip 压缩包，复制到 /home/linux 目录；
2. 终端执行以下命令解压：

   cd /home/linux
   unzip clangd-linux-14.0.3.zip
   

3. 解压完成后，settings.json 中已配置 clangd 路径，无需额外操作。

6.2 安装 clang-format（代码格式化工具）

clang-format 用于代码自动对齐，提升代码可读性，终端执行以下命令安装：

sudo apt-get install clang-format

安装完成后，VS Code 会自动调用该工具进行代码格式化（已在 settings.json 中配置 formatOnSave，保存时自动格式化）。

验证配置

1. 启动 VS Code，新建一个 .c 文件，输入以下测试代码：

   #include <stdio.h>
   int main() {
   printf("Hello Ubuntu VS Code!\n");
   return 0;
   }
   

2. 保存文件（Ctrl+S），观察代码是否自动格式化对齐；
3. 检查语法高亮是否正常，输入 printf 时是否有智能提示；
4. 终端执行 gcc 文件名.c -o 文件名，编译无报错说明配置正常。

注意事项

1. 网络配置若仍不通，可检查主机防火墙是否阻止虚拟机网络，或切换为「桥接模式」重试；
2. 安装 VS Code 时若提示依赖缺失，执行 sudo apt-get -f install 修复依赖后重新安装；
3. 插件安装失败可尝试切换网络或重启 VS Code，国内网络建议使用阿里云源加速；
4. 若 clangd 无法正常工作，检查 clangd.path 配置是否与解压路径一致。