📚 课程目录第2章命令行基础

2. 命令行基础：终端环境准备与基本语法

各位工程师，大家好。欢迎来到《烧录工具命令行操作与参数调优调试技巧》的第二章节。

说实话，很多做嵌入式开发的朋友，一开始接触烧录工具时，第一反应就是去找那个图形界面。点一下“Download”按钮，看着进度条跑完，完事。但真正到了产线调试、批量烧录、或者遇到那种“死活连不上”的诡异问题时，你会发现，图形界面根本给不了你足够的信息。

这时候，命令行才是你的真家伙。我个人的习惯是，只要不是第一次验证硬件，我基本都开终端干活。为什么？因为你能看到每一条指令的反馈，能精确控制每一个参数，还能写脚本一键搞定。

这一章，我们就先把“战场”打扫干净——把终端环境准备好，把路（PATH）铺好，再把命令行的基本语法捋一遍。别小看这些基础，我见过太多工程师因为一个空格、一个斜杠的方向，浪费了一整个下午。

不同的操作系统，终端长得不一样，但核心逻辑是一样的。我们一个一个来看。

Windows 下，你主要面对两个终端：CMD（命令提示符）和 PowerShell。

CMD：老牌终端，兼容性好，很多老烧录工具的命令行版本只认 CMD。启动方式：Win + R，输入 cmd，回车。
PowerShell：功能更强大，支持对象管道，但语法和 CMD 有些不同。启动方式：右键点击“开始”菜单，选择“Windows PowerShell”或“终端”。

我的建议： 如果你只是跑烧录命令，用 CMD 就够了，省心。如果你需要写复杂的脚本处理日志、解析输出，PowerShell 更合适。我个人在产线调试时，习惯开两个窗口：一个 CMD 跑烧录，一个 PowerShell 分析日志。

Linux 和 macOS 的终端（Terminal）本质上是 Unix Shell，最常见的是 Bash 或 Zsh。启动方式：

这两个系统的终端体验非常接近，很多烧录工具（比如 OpenOCD、JLinkExe）在 Linux 下跑得比 Windows 还稳。我记得有一次在产线上，Windows 下的驱动死活装不上，换到 Ubuntu 系统，一条命令就识别了芯片，省了不少事。

好，终端打开了。现在你输入 jlink 或者 openocd，系统提示“命令未找到”。

为什么会这样？因为你还没告诉系统，这些烧录工具的可执行文件放在哪。这就是 PATH 环境变量的作用。

PATH 说白了，就是一个文件夹列表。当你在终端输入一个命令时，系统会按顺序在这个列表里找，有没有同名的可执行文件。找到了就运行，找不到就报错。

注意： 我曾经遇到过一位同事，把路径写成了 C:\Program Files\SEGGER\JLink_V794e\JLink.exe。这是错的！PATH 里应该放文件夹路径，不是文件路径。系统会自动去那个文件夹里找 .exe 文件。

在 Linux 或 macOS 下，配置 PATH 通常修改 Shell 配置文件：

在文件末尾添加一行：

export PATH=$PATH:/opt/SEGGER/JLink_V794e

然后执行 source ~/.bashrc 使其立即生效。

一个小技巧： 配置完后，在终端输入 which jlink（Linux/macOS）或 where jlink（Windows），如果返回了路径，说明配置成功了。这是我最常用的验证方法。

环境准备好了，我们来聊聊命令行的“语法”。其实很简单，就三个要素：

一个典型的烧录命令长这样：

openocd -f interface/jlink.cfg -f target/stm32f4x.cfg -c "program firmware.hex verify reset exit"

这里面：openocd 是命令；-f 和 -c 是选项；interface/jlink.cfg、target/stm32f4x.cfg、"program firmware.hex verify reset exit" 都是参数。

  避坑指南： 我曾经在调试一个脚本时，把 -f 写成了 -F，结果 OpenOCD 报错说找不到配置文件。大小写在命令行里是敏感的，尤其是 Linux 下。记住：-f 和 -F 是两个完全不同的选项。

为了让你更直观地理解这一章的内容结构，我画了一张图。它把终端环境、PATH 配置、命令语法这三个核心模块串了起来，方便你以后复习时一眼看清脉络。

这一章我们做了三件事：