当前位置：首页 > news >正文

WebRTC系列：（一）MacOS开发环境搭建（Vscode + Clangd）

news 2025/6/30 10:15:54

WebRTC系列（一）：MacOS开发环境搭建（VSCode + Clangd）

引言

为什么选择这个组合？

Clangd：LLVM官方语言服务器，精准代码分析，秒级跳转
VSCode：轻量级IDE，完美适配Clangd
MacOS：WebRTC官方推荐开发平台之一

一、环境准备

准备工作

确保你已经安装了以下工具：
- Xcode 和命令行工具
- Homebrew
- Git
- Python 2.7 (libwebrtc 构建需要)
- Ninja (构建工具)

1. 安装必要依赖

# 安装必要的工具
brew install git ninja

2. 获取 libwebrtc 代码

# 创建工作目录
mkdir webrtc-checkout
cd webrtc-checkout# 获取 depot_tools (Google 的代码管理工具)
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH=$PATH:`pwd`/depot_tools# 获取 WebRTC 代码
fetch --nohooks webrtc
gclient sync

1. 安装基础工具

# 1. 安装Homebrew（已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"# 2. 安装必要工具链
brew install git python ninja clang-format pkg-config

2. 获取WebRTC源码（打开科学上网）

mkdir ~/webrtc && cd ~/webrtc
fetch --nohooks webrtc
gclient sync

二、配置Clangd

1. 生成编译命令数据库

cd src
gn gen out/Default --args='is_debug=true use_rtti=true is_component_build=false' --export-compile-commands
ln -sf out/Default/compile_commands.json .

2. 安装VSCode插件

安装 Clangd
禁用微软的C/C++扩展（避免冲突）

3. 关键配置（`.vscode/settings.json`）

{"clangd.path": "/usr/bin/clangd", // 指定clangd路径"clangd.arguments": ["--background-index","--compile-commands-dir=${workspaceFolder}/out/Default","--query-driver=${workspaceFolder}/third_party/llvm-build/Release+Asserts/bin/clang++",],"C_Cpp.intelliSenseEngine": "Disabled" // 禁用冲突的C/C++扩展
}

三、生成项目的配置文件

1. 生成构建配置

gn gen out/Default --args='is_debug=true use_rtti=true is_component_build=false' --export-compile-commands

2. 编译（可选）

ninja -C out/Default

3. 使用 .clangd 文件加强语法识别

为了防止有些.h被错误的使用c语法解析，可以在 webrtc/src 下添加一个 .clangd 文件，内容如下：


CompileFlags:Add: - -std=c++17- -xc++- -I./- -I./third_party/libc++/src/include

这样即使 .h 文件没有在 compile_commands.json 中，也能以 C++ 方式被解析。

四、验证环境

测试跳转：
- 打开 pc/peer_connection.cc
- Ctrl+Click 任意符号（如 PeerConnection）应跳转到定义
测试补全：
- 输入 peer_connection-> 应弹出成员函数列表
检查clangd
- 下面的状态应该显示为indexing