24.1 code-server 和 clangd 开发环境

code-server 是 Visual Studio Code 的开源服务器版本，可在远程服务器上运行并通过浏览器访问。

24.1.1 安装 code-server

使用 pkg 安装：

# pkg install code-server

使用 Ports 安装：

# cd /usr/ports/www/code-server/ 
# make install clean

启用服务：

# sysrc code_server_enable=YES
# service code-server start

在浏览器中访问 http://127.0.0.1:8080 即可使用该服务。

警告

建议不要在未配置认证/HTTPS 时直接对外网或局域网开放该端口。

24.1.2 服务器安装 LLVM 与 clangd 插件

在 FreeBSD 上本地安装 LLVM 工具链，并配置 code-server：

# pkg install -y llvm # 安装 LLVM 工具链
# code-server --install-extension llvm-vs-code-extensions.vscode-clangd   # 在 code-server 中安装 clangd 扩展

24.1.3 （示例）在浏览器中用 code-server 打开 FreeBSD 的源代码树

使用 code-server 打开 /usr/src 目录作为工作区：

# code-server /usr/src

24.1.4 （示例）在浏览器中编译最小化内核并生成 compile_commands.json 文件

安装 Bear 工具并生成内核构建的编译命令数据库：

# pkg install bear   # 安装 Bear 工具，用于生成 compile_commands.json
# bear --append -- make KERNCONF=MINIMAL buildkernel   # 使用 Bear 生成内核构建的编译命令，并构建 MINIMAL 内核

等待编译完成并生成 compile_commands.json 文件后，即可开始阅读内核关键部分的源代码。

24.1.5 故障排除与未竞事宜

24.1.5.1 HTTPS 配置

本节未涉及如何在服务器上通过 HTTPS 提供 code-server 服务。如需配置 HTTPS，可参考 code-server 官方文档配置 SSL 证书。