源码都没调试过，怎么能说熟悉 redis 呢？

一：背景

1. 讲故事

记得在很久之前给初学的朋友们录制 redis 视频课程，当时结合了不少源码进行解读，自以为讲的还算可以，但还是有一个非常核心的点没被分享到，那就是源码级调试，

对，读源码还远远不够，还得亲自实操，为了弥补这个遗憾，这一篇就补起来哈。

二：vscode 和 redis 的部署

1. 平台和调试工具

大家都知道 官方版redis 是不支持 windows 的，即使被微软开源技术社区移植到了 windows 平台，版本滞后就不说了，无数潜在的 bug 可能会让你望而却步，gitbub地址：https://github.com/microsoftarchive/redis 目前最新的版本是 3.0.5, 官方都已经是 6.0.9 啦！ 😮

扯这么多的意思就是想说不要指望用 windows + visualstudio 调试源码，更何况这里还要调试最新版的 redis6， 只能上 centos + vscode 了哈 🤭🤭🤭

2. vscode 在 centos 上的安装

• 官方地址下载 vscode，这里我用的版本是 1.23，参考网址： https://code.visualstudio.com/updates/v1_23

[root@localhost data]# wget https://vscode.cdn.azure.cn/stable/d0182c3417d225529c6d5ad24b7572815d0de9ac/code-1.23.1-1525968555.el7.x86_64.rpm
--2020-10-27 07:03:08--  https://vscode.cdn.azure.cn/stable/d0182c3417d225529c6d5ad24b7572815d0de9ac/code-1.23.1-1525968555.el7.x86_64.rpm
Resolving vscode.cdn.azure.cn (vscode.cdn.azure.cn)... 119.39.80.117, 14.204.144.133, 153.37.238.225, ...
Connecting to vscode.cdn.azure.cn (vscode.cdn.azure.cn)|119.39.80.117|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 69499838 (66M) [application/x-redhat-package-manager]
Saving to: ‘code-1.23.1-1525968555.el7.x86_64.rpm’

100%[===================================================================================================================>] 69,499,838  3.36MB/s   in 19s    

2020-10-27 07:03:28 (3.40 MB/s) - ‘code-1.23.1-1525968555.el7.x86_64.rpm’ saved [69499838/69499838]

• 安装 vscode 的依赖包 libXScrnSaver, nss

[root@localhost code]# yum install libXScrnSaver-devel.x86_64 libXScrnSaver.x86_64 && yum install nss

• rpm 安装 vscode

[root@localhost data]# rpm -ivh code-1.23.1-1525968555.el7.x86_64.rpm
Preparing...                          ################################# [100%]
Updating / installing...
   1:code-1.23.1-1525968555.el7       ################################# [100%]

安装完后就可以在 centos 上找到 vscode 的启动图标了，🐂🙅‍🐂。

3. redis6 源码下载

这里有一个坑要提醒一下，如果你编译 redis6 的话，centos7 的 gcc 默认是 4.8.5，你需要升级一下：

[root@localhost redis-6.0.9]# gcc -v
gcc version 4.8.5 20150623 (Red Hat 4.8.5-39) (GCC) 
[root@localhost ~]# yum -y install centos-release-scl
[root@localhost ~]# yum -y install devtoolset-9-gcc devtoolset-9-gcc-c++ devtoolset-9-binutils
[root@localhost ~]# source /opt/rh/devtoolset-9/enable
[root@localhost redis-6.0.9]# gcc -v
gcc version 9.3.1 20200408 (Red Hat 9.3.1-2) (GCC)

然后就可以源码下载，编译，启动，直接参考官方文档来: https://redis.io/download

$ wget https://download.redis.io/releases/redis-6.0.9.tar.gz
$ tar xzf redis-6.0.9.tar.gz
$ cd redis-6.0.9
$ make
$ src/redis-server

没什么好说的，执行完后的启动界面如下：

三： vscode 调试 redis

1. 使用 vscode 安装 c/c++ 扩展

具体用法和 windows 上的 vscode 差不多，该怎么装还怎么装。

2. 使用 debug 生成 launch.json 启动文件

菜单栏 "Debug" -> "Starting Debug"，然后选择 "C++ (GDB/LLDB)"，如下图：

再配置一下启动文件 .vscode/launch.json，将 ${workspaceFolder}/src/redis-server 程序的路径配置在 program 节点下，如下代码所示：

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/src/redis-server",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

3. 生成编译指令文件 tasks.json

在 .vscode 目录下新建 tasks.json，使用 make 命令编译 redis 源码，最后由 launch.json 读取生成好的 可执行文件 redis-server，代码如下：

{
	"version": "2.0.0",
	"tasks": [{
		"label": "Build",
		"type": "shell",
		"command": "make",
		"args": [
			"CFLAGS=\"-g -O0\""
		]
	}]
}

4. 调试执行

在 server.c 中找到 main 启动函数，下一个断点过去，按 F5 执行，如下图可以看到断点已命中。

为了更加逼真一点，我在 string.c 中的 setCommand 处设置断点，保证 redis-cli 在执行 set username jack 时断点命中。

• client 端

[root@localhost src]# ./redis-cli
127.0.0.1:6379> set username jack

• server 端

怎么样，图中左侧面板中的 局部变量窗口，监控窗口，调用堆栈窗口，一目了然。。。

四：总结

总的来说，整个搭建过程有一定的繁琐度，但学啥又简单呢？ 再说源码都没调试过，怎么能说熟悉 redis 呢？最后祝大家有一个开心的 redis 调试之旅！