文章目录
- VScode clangd 插件浏览 linux 源码
- clangd 安装与配置
- VScode 插件安装
- clangd 安装
- 方法一
- 方法二
 
- clangd 配置
 
- cmake 生成
- bear 生成 `compile_commands.json`
- 触发 clangd
 
- linux 内核脚本生成 `compile_commands.json` 文件
- 三种方式对比
 
VScode clangd 插件浏览 linux 源码
VScode clangd 插件浏览代码却决于 compile_commands.json 文件
 生成该文件有很多种方法
- bear 命令
- linux 内核脚本
- cmake 编译选项
clangd 安装与配置
VScode 插件安装
在 VScode 插件商城搜索安装即可
clangd 安装
方法一
插件下载好之后任意打开一个 C/CPP 文件,vscode 下方会出现弹窗直接 install 即可(若网络原因或其他原因这里一直下载不出来请参考方式二)
 
方法二
从GitHub上下载 clangd-language,网址:https://githubfast.com/clangd/clangd/releases/
 
 选择适合自己的即可,解压之后需要告诉 VScode 你的 clangd 的地址
Ctrl + , 打开配置,输入 clangd
 
 输入自己的 path 即可(如果是方法一这里会自动填充)
/home/tyustli/.vscode-server/data/User/globalStorage/llvm-vs-code-extensions.vscode-clangd/install/16.0.2/clangd_16.0.2/bin/clangd
clangd 配置
由于 clangd 插件和 c/c++ 插件会存在冲突,在 ./vscode/settings.json 文件中添加下面一行配置,将 C/C++ 功能禁止掉
"C_Cpp.intelliSenseEngine": "disabled",
cmake 生成
cmake工程生成 compile_commands.json 文件比较简单,定义 CMAKE_EXPORT_COMPILE_COMMANDS 即可。
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1
bear 生成 compile_commands.json
 
不过很多工程都是用 Makefile 来编译的,例如 linux 内核,没有现成的选项生成 compile_commands.json 文件。我们可以通过 bear 来生成。
bear 生成之前需要确保没有编译过,或者
make clean一下,否则生成的文件是空的!!!
安装 bear
sudo apt-get install bear
使用 bear -- make 编译(之前的命令是 bear make)
编译 linux 内核生成
export ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf-   # 设置编译平台和工具链
make vexpress_defconfig                                 # 加载板子的配置信息
make dtbs                                               # 编译设备树
bear -- make -j8                                                # 编译内核
生成之后将 /usr/bin/gcc 全局搜索替换为自己工具链路径 /home/tyustli/cross_tool/gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-gcc
生成的部分 compile_commands.json 文件如下
  {
    "arguments": [
      "/home/tyustli/cross_tool/gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-gcc",
      "-Wp,-MMD,scripts/mod/.empty.o.d",
      "-nostdinc",
      "-I./arch/arm/include",
      "-I./arch/arm/include/generated",
      "-I./include",
      "-I./arch/arm/include/uapi",
      "-I./arch/arm/include/generated/uapi",
      "-I./include/uapi",
      "-I./include/generated/uapi",
      "-include",
      "./include/linux/compiler-version.h",
      "-include",
      "./include/linux/kconfig.h",
      "-include",
      "./include/linux/compiler_types.h",
      "-D__KERNEL__",
      "-mlittle-endian",
      "-D__LINUX_ARM_ARCH__=7",
      "-fmacro-prefix-map=./=",
      "-std=gnu11",
      "-fshort-wchar",
      "-funsigned-char",
      "-fno-common",
      "-fno-PIE",
      "-fno-strict-aliasing",
      "-Wall",
      "-Wundef",
      "-Werror=implicit-function-declaration",
      "-Werror=implicit-int",
      "-Werror=return-type",
      "-Werror=strict-prototypes",
      "-Wno-format-security",
      "-Wno-trigraphs",
      "-fno-dwarf2-cfi-asm",
      "-mno-fdpic",
      "-fno-ipa-sra",
      "-mtp=cp15",
      "-mabi=aapcs-linux",
      "-mfpu=vfp",
      "-funwind-tables",
      "-marm",
      "-Wa,-mno-warn-deprecated",
      "-march=armv7-a",
      "-msoft-float",
      "-Uarm",
      "-fno-delete-null-pointer-checks",
      "-Wno-frame-address",
      "-Wno-format-truncation",
      "-Wno-format-overflow",
      "-Wno-address-of-packed-member",
      "-O2",
      "-fno-allow-store-data-races",
      "-Wframe-larger-than=1024",
      "-fstack-protector-strong",
      "-Wno-main",
      "-Wno-unused-but-set-variable",
      "-Wno-unused-const-variable",
      "-fomit-frame-pointer",
      "-fno-stack-clash-protection",
      "-Wvla",
      "-Wno-pointer-sign",
      "-Wcast-function-type",
      "-Wno-stringop-truncation",
      "-Wno-stringop-overflow",
      "-Wno-restrict",
      "-Wno-maybe-uninitialized",
      "-Wno-alloc-size-larger-than",
      "-Wimplicit-fallthrough=5",
      "-fno-strict-overflow",
      "-fno-stack-check",
      "-fconserve-stack",
      "-Werror=date-time",
      "-Werror=incompatible-pointer-types",
      "-Werror=designated-init",
      "-Wno-packed-not-aligned",
      "-g",
      "-fplugin=./scripts/gcc-plugins/arm_ssp_per_task_plugin.so",
      "-DKBUILD_MODFILE=\"scripts/mod/empty\"",
      "-DKBUILD_BASENAME=\"empty\"",
      "-DKBUILD_MODNAME=\"empty\"",
      "-D__KBUILD_MODNAME=kmod_empty",
      "-c",
      "-o",
      "scripts/mod/empty.o",
      "scripts/mod/empty.c"
    ],
    "directory": "/home/tyustli/code/open_source/kernel/linux-6.5.7",
    "file": "/home/tyustli/code/open_source/kernel/linux-6.5.7/scripts/mod/empty.c",
    "output": "/home/tyustli/code/open_source/kernel/linux-6.5.7/scripts/mod/empty.o"
  },
从该文件可以看到,每个编译的文件的详细信息都被记录在 compile_commands.json 文件中。
触发 clangd
在 VScode 里打开任意一个 C 文件,就会触发 clangd 建立索引:
 
 如果正在建立索引,显示的是 indexing:1276/1699
索引建立完成之后
 
 如果索引建立完成轴,显示的是 clangd: idle。
此时 linux 代码可以任意跳转了。
linux 内核脚本生成 compile_commands.json 文件
 
linux 内核提供了生成该文件的脚本
scripts/clang-tools/gen_compile_commands.py 
执行该脚本之前需要确保内核已经编译过!!!
执行该脚本即可生成 compile_commands.json 文件
python3 ./scripts/clang-tools/gen_compile_commands.py 
生成的部分内容如下
  {
    "command": "arm-none-linux-gnueabihf-gcc -Wp,-MMD,block/.genhd.o.d -nostdinc -I./arch/arm/include -I./arch/arm/include/generated  -I./include -I./arch/arm/include/uapi -I./arch/arm/include/generated/uapi -I./include/uapi -I./include/generated/uapi -include ./include/linux/compiler-version.h -include ./include/linux/kconfig.h -include ./include/linux/compiler_types.h -D__KERNEL__ -mlittle-endian -D__LINUX_ARM_ARCH__=7 -fmacro-prefix-map=./= -std=gnu11 -fshort-wchar -funsigned-char -fno-common -fno-PIE -fno-strict-aliasing -Wall -Wundef -Werror=implicit-function-declaration -Werror=implicit-int -Werror=return-type -Werror=strict-prototypes -Wno-format-security -Wno-trigraphs -fno-dwarf2-cfi-asm -mno-fdpic -fno-ipa-sra -mtp=cp15 -mabi=aapcs-linux -mfpu=vfp -funwind-tables -marm -Wa,-mno-warn-deprecated -march=armv7-a -msoft-float -Uarm -fno-delete-null-pointer-checks -Wno-frame-address -Wno-format-truncation -Wno-format-overflow -Wno-address-of-packed-member -O2 -fno-allow-store-data-races -Wframe-larger-than=1024 -fstack-protector-strong -Wno-main -Wno-unused-but-set-variable -Wno-unused-const-variable -fomit-frame-pointer -fno-stack-clash-protection -Wvla -Wno-pointer-sign -Wcast-function-type -Wno-stringop-truncation -Wno-stringop-overflow -Wno-restrict -Wno-maybe-uninitialized -Wno-alloc-size-larger-than -Wimplicit-fallthrough=5 -fno-strict-overflow -fno-stack-check -fconserve-stack -Werror=date-time -Werror=incompatible-pointer-types -Werror=designated-init -Wno-packed-not-aligned -g -fplugin=./scripts/gcc-plugins/arm_ssp_per_task_plugin.so -fplugin-arg-arm_ssp_per_task_plugin-offset=1248    -DKBUILD_MODFILE='\"block/genhd\"' -DKBUILD_BASENAME='\"genhd\"' -DKBUILD_MODNAME='\"genhd\"' -D__KBUILD_MODNAME=kmod_genhd -c -o block/genhd.o block/genhd.c",
    "directory": "/home/tyustli/code/open_source/kernel/linux-6.5.7",
    "file": "/home/tyustli/code/open_source/kernel/linux-6.5.7/block/genhd.c"
  },
三种方式对比
- cmake 
  - 优点:简单,加入 cmake 选项即可
- 缺点: 依赖于 cmake 工程
 
- bear(未编译之前使用) 
  - 优点:任意 Makefile 工程都能使用
- 缺点:如果改动了源码或者文件依赖,bear 每次都要重新编译
 
- linux 脚本(编译之后使用) 
  - 优点:简单,只需要 python 执行一下即可
- 缺点:局限于 linux 工程
 
对于研究 linux 内核,直接使用 linux 提供的脚本这种方法最合适。



















