View source for Emacs 写 C 项目步骤

{| class="wikitable"
!命令 / 工具
!实质
!解决的痛点
|-
|<code>sudo apt install build-essential</code>
|安装基础 C/C++ 构建工具集合，包含 GCC、Make 等
|Emacs 本身不负责把 C 源码编译成程序
|-
|<code>sudo apt install gdb</code>
|安装 '''GDB 调试器'''
|Emacs 本身没有 C 程序的底层调试能力
|-
|<code>M-x compile</code>
|在当前 buffer 的 <code>default-directory</code> 中启动一个异步编译命令
|不必离开 Emacs 去终端编译；编译结果还能被 Emacs 解析
|-
|<code>gcc -std=c17 -Wall -Wextra -Wpedantic -g -O0 main.c -o hello</code>
|一条具体的 GCC 编译命令
|明确使用什么标准、警告、调试信息和输出文件
|-
|<code>M-x project-shell</code>
|在'''项目根目录'''启动 Shell
|不管当前文件藏在 <code>src/</code> 多深，都能直接从项目根运行 <code>./hello</code>、<code>make</code> 等
|-
|<code>M-x shell</code>
|在当前 buffer 的 <code>default-directory</code> 启动 Shell
|在 Emacs 内直接使用普通 Shell
|-
|<code>M-x project-compile</code>
|在'''项目根目录'''启动 Compilation
|避免当前文件位于 <code>src/</code> 时，从错误目录执行 <code>make</code>
|-
|<code>M-x recompile</code>
|重复最近一次 Compilation 命令
|避免反复输入 <code>make -k</code>、GCC 参数等
|-
|<code>Makefile</code>
|描述构建目标、依赖关系和构建规则
|不再手写长串 GCC 命令；项目只重新编译必要部分，并让构建方法可重复
|-
|<code>M-x gdb</code>
|启动 '''GDB 调试器'''，并进入 Emacs 的图形化 GDB 界面
|在 Emacs 中调试已经编译出来的程序
|-
|<code>M-x gud-break</code>
|【源码 buffer】在当前代码行设置断点
|让程序运行到指定位置时暂停，方便观察当时的变量、调用栈和状态
|-
|点击 fringe 红点
|【GDB 管理的源码 buffer】图形化设置/删除 breakpoint
|和 <code>gud-break</code> 本质一样，只是鼠标操作更直观
|-
|<code>M-g n</code>（<code>next-error</code>）
|跳到下一条已解析的错误/警告对应源码位置
|不必看着 <code>main.c:37:5</code> 再手工寻找第 37 行
|-
|<code>M-x gud-next</code>
|【源码 buffer】执行下一行，但'''不进入'''被调用函数
|想逐行观察流程，但暂时不关心函数内部
|-
|<code>M-x gud-step</code>
|【源码 buffer】执行下一步，并'''进入'''被调用函数
|怀疑某个函数内部出了问题，需要钻进去看
|-
|<code>M-x gud-cont</code>
|【源码 buffer】继续运行，直到下一个断点/异常
|不需要一行一行走完整个程序
|-
|<code>M-x gud-finish</code>
|【源码 buffer】运行到当前函数返回
|已经确认这个函数没问题，快速退出它
|-
|<code>M-x gud-up</code>
|【源码/GDB 调试上下文】切换到调用栈的上一层 stack frame
|查看“是谁调用了当前函数”，以及调用者当时的变量
|-
|<code>(gdb) print numerator</code>
|【GDB buffer】计算并显示一个表达式当前的值
|查看程序暂停这一刻变量到底是什么
|-
|<code>(gdb) backtrace</code> / <code>bt</code>
|【GDB buffer】显示整个调用栈
|搞清楚程序是沿着哪条函数调用路径走到当前位置的
|}
                写 C

                  │

              main.c

                  │

          GCC / Make

        【负责构建】

                  │

                hello

             可执行程序

                  │

          ┌───────┴────────┐

          ↓                ↓

       直接运行            GDB

      ./hello           【负责调试】

                           │

                   breakpoint

                   next / step

                   print / bt

Emacs 把这一切包起来：

源码 buffer

    ↕

Compilation buffer

    ↕

Shell buffer

    ↕

GDB buffer