别怕黑窗口：写给小白的 CLI 入门指南

​ 你翻技术文章，三篇里有两篇会蹦出一行长这样的东西：

npx typeui.sh pull enterprise

​ 然后作者轻描淡写一句"运行以下命令即可"，就没了。

​ 你盯着这行字想：这东西往哪儿输？在哪个软件里运行？为什么技术文章默认所有人都会这个？

​ 如果你有这种困惑，这篇文章就是写给你的。

一、CLI 是什么：用打字代替点鼠标

​ CLI，全称 Command Line Interface，命令行界面。

​ 你日常操作电脑，用的是 GUI（Graphical User Interface，图形界面），窗口、图标、按钮、菜单，鼠标点点点就行。

​ CLI 是另一种操作方式：没有窗口、没有按钮，只有一个文本框，你输入一行命令，电脑执行一个动作。

• 举个例子。你想在桌面上新建一个叫"项目"的文件夹：

  GUI 操作	CLI 操作
  右键桌面 → 新建 → 文件夹 → 输入名字 → 回车	mkdir 项目
  5 次鼠标操作	1 行命令

  ​ 两种方式的结果完全一样，桌面上多了一个"项目"文件夹。区别只在于交互方式：一个用鼠标点，一个用键盘打。
  

​ GUI 和 CLI 不是"高级 vs 低级"的关系，只是两种不同的交互方式。GUI 直观友好，CLI 快速精准。就像你去餐厅可以看菜单图片点菜（GUI），也可以直接报菜名（CLI），结果一样，方式不同。

二、那个"黑窗口"在哪

​ CLI 的操作界面叫终端（Terminal），每个操作系统都自带一个，不需要额外安装。

2.1 Windows

​ 你有三个选择：

终端	怎么打开	说明
Windows Terminal	开始菜单搜索"Terminal"	Windows 11 自带，推荐使用
PowerShell	开始菜单搜索"PowerShell"	Windows 10/11 都有
CMD	开始菜单搜索"cmd"	最老的那个，功能有限但够用

​ 最快的打开方式：按 Win + R，输入 cmd，回车。

2.2 Mac

​ 打开 Terminal（终端）：

• 方式一：Command + 空格，输入"Terminal"，回车
  

• 方式二：访达 → 应用程序 → 实用工具 → 终端

2.3 Linux

​ 打开 Terminal（终端）：

• 方式一：快捷键 Ctrl + Alt + T，大多数发行版通用

• 方式二：在应用菜单里搜索"Terminal"或"终端"

• 方式三（Ubuntu）：点击屏幕左下角"显示应用程序" → 搜索"Terminal"

  打开之后，你会看到一个窗口，里面有一行文字，末尾闪烁着一个光标。

2.4 提示符的含义

​ 提示符告诉你两件事：你是谁，和你现在在哪个文件夹。光标闪烁的地方就是你输入命令的地方。

​ 三个系统的终端长得不一样，但工作方式完全相同：看到提示符 → 输入命令 → 按回车 → 看结果。学会一个，其他的都会了。

三、先学会 5 个命令，够用了

​ CLI 的命令有成百上千个，但日常只需要记住 5 个。我们用文件管理器的类比来理解它们：

3.1 pwd — 我现在在哪

pwd

​ 输出：

/Users/你的用户名/Desktop

​ 相当于看文件管理器顶部的地址栏。pwd 是 Print Working Directory 的缩写——“打印当前工作目录”。

Windows CMD 里对应的命令是 cd（不带参数），PowerShell 里 pwd 也能用。

3.2 ls — 这里面有什么

ls

输出：

Documents   Downloads   Pictures   项目

相当于打开一个文件夹，看看里面有哪些文件和子文件夹。ls 是 List 的缩写。

Windows CMD 里对应的命令是 dir。

3.3 cd — 我要去别的文件夹

cd Documents

​ 相当于双击"Documents"文件夹进去。cd 是 Change Directory 的缩写。

​ 几个常用的特殊写法：

cd ..          # 返回上一级（相当于点"返回"按钮）
cd ~           # 回到用户主目录（相当于回到"家"）
cd /           # 回到根目录（相当于回到"此电脑"最顶层）

3.4 mkdir — 新建文件夹

mkdir 我的项目

相当于右键 → 新建文件夹 → 输入名字。mkdir 是 Make Directory 的缩写。

3.5 cat — 看看文件内容

cat readme.txt

​ 相当于双击打开一个文本文件，把内容显示在屏幕上。

​ 把这 5 个串起来，一个完整的操作流程：

pwd                  # 看看我在哪
ls                   # 看看这里有什么
cd Documents         # 进入 Documents 文件夹
mkdir 我的项目        # 在这里新建一个文件夹
cd 我的项目           # 进入新文件夹
ls                   # 看看里面有什么（空的）

​ 翻译成 GUI 操作就是：看一眼桌面 → 打开"文档" → 新建文件夹 → 双击进去。完全一样的事情，只是换了一种方式。

​ 这 5 个命令覆盖了 80% 的日常操作。你不需要一次性学几十个命令，先把这 5 个用熟，其他的遇到再查。

四、读懂技术文章里的命令

​ 学会了基础命令，回到最初的问题：技术文章里那些命令到底在说什么？

4.1 解剖一条典型命令

npx typeui.sh pull enterprise

​ 拆开看：

部分	含义
npx	Node.js 的工具，用来运行 npm 包里的命令。你可以理解为"帮我临时下载并运行一个工具"
typeui.sh	要运行的工具名称
pull	这个工具提供的子命令，表示"拉取/下载"
enterprise	参数，指定要拉取的具体内容

​ 翻译成大白话：用 npx 临时运行 typeui.sh 这个工具，执行它的 pull 功能，下载 enterprise 这个设计风格。

4.2 常见的命令模式

​ 技术文章里的命令虽然千变万化，但结构都遵循同一个模式：

工具名  动作  参数  [选项]

​ 几个例子：

git clone https://github.com/xxx/yyy
# 工具:git  动作:clone(克隆)  参数:仓库地址

npm install express
# 工具:npm  动作:install(安装)  参数:express(包名)

docker run -p 3000:3000 myapp
# 工具:docker  动作:run(运行)  参数:myapp(镜像名)  选项:-p 3000:3000(端口映射)

​ 看到 -- 或 - 开头的部分，那是选项（flag），用来调整命令的行为：

ls -l           # -l 表示"用列表格式显示详细信息"
npm install -g  # -g 表示"全局安装"
git commit -m "修复bug"  # -m 表示"附带一条消息"

4.3 那些"前置条件"

​ 技术文章经常假设你已经装好了某些工具。常见的前置依赖：

文章里写的	你需要先安装	去哪下载
npx xxx / npm install	Node.js	nodejs.org
pip install	Python	python.org
git clone	Git	git-scm.com
docker run	Docker	docker.com

​ 如果运行命令报错"command not found"，99% 的原因是你没装对应的工具。先装工具，再跑命令。
​ 下次在技术文章里看到一条陌生命令，先别慌。按"工具 → 动作 → 参数"的模式拆一下，基本就能猜出它在干什么。猜不出来也没关系，命令名本身就是英文单词的缩写，pull 就是拉取，install 就是安装，clone 就是克隆。

五、动手试试：一个 5 分钟的练习

5.1 Try it

​ 光看不练假把式。打开你的终端，跟着做一遍：

# 第一步：看看你在哪
pwd

# 第二步：看看这里有什么
ls

# 第三步：新建一个练习文件夹
mkdir cli-practice

# 第四步：进去
cd cli-practice

# 第五步：确认你进来了
pwd

# 第六步：创建一个文件（Mac/Linux）
echo "我学会 CLI 了" > hello.txt

# Windows PowerShell 版本：
# "我学会 CLI 了" | Out-File hello.txt

# 第七步：看看文件内容
cat hello.txt

# 第八步：退回上一级
cd ..

# 第九步：确认退回来了
pwd

​ 如果你成功看到了"我学会 CLI 了"这行字，恭喜——你已经完成了第一次命令行操作。

5.2 犯错了怎么办

​ 初学者最大的恐惧是：万一输错命令把电脑搞坏了怎么办？

​ 放心。CLI 没那么危险，有几个安全常识：

• 输错了直接回车：最多报一个 “command not found”，不会爆炸
• 想取消正在运行的命令：按 Ctrl + C，强制停止
• 想清空屏幕：输入 clear（或按 Ctrl + L），屏幕干净了但什么都没删
• 想看历史命令：按键盘 ↑ 箭头，可以翻出之前输过的命令
• 真正危险的命令（比如 rm -rf /）你不会"不小心"输出来，它需要你精确地打出每一个字符。
  ​ 跟着做完这 9 步，你就从"看到黑窗口就紧张"变成了"至少知道怎么在里面走路"。CLI 的学习曲线在最开始那一下，一旦你迈过"打开终端、输入第一条命令"这个坎，后面就是自然而然地慢慢积累。

六、为什么开发者这么爱 CLI

​ 你可能会想：既然 GUI 这么直观，为什么程序员非要用这个黑窗口？

6.1 快

​ 鼠标操作需要：找到目标 → 移动光标 → 点击 → 等界面响应。命令行只需要：打字 → 回车。对于熟练的开发者，打字速度远快于鼠标操作。

6.2 可自动化

​ GUI 操作没法"录制"，你不能告诉电脑"帮我重复刚才的 50 次鼠标点击"。但 CLI 命令就是文本，可以写进脚本文件，一键执行上百个操作：

# 一个脚本文件，一次性完成项目初始化
mkdir my-project
cd my-project
git init
npm init -y
npm install express
echo "项目初始化完成"

​ 把这些命令保存成一个 .sh 文件，以后每次新建项目只要运行一下这个文件就行。一次编写，反复使用。

6.3 可远程

​ 你没法给一台远在另一个城市的服务器"接鼠标"。但你可以通过网络连接到它的命令行（用 SSH），远程操作就像坐在它面前一样。全世界的服务器几乎都是通过 CLI 来管理的。

6.4 可复制传播

​ 技术文章里写"点击这个按钮，再点击那个菜单……"，读者可能找不到对应的位置（界面版本不同、语言不同、布局改了）。但写一条命令，读者复制粘贴就能跑，命令就是最精确的操作说明。

​ 这也是为什么技术文章里 CLI 命令出现的频率远高于截图教程。不是作者偷懒，是命令比截图更不容易过时。

七、CLI 工具 vs CLI 本身

​ 最后澄清一个容易混淆的概念。

• 当技术文章说"typeui.sh 是一个 CLI 工具"时，它不是说 typeui.sh 就是那个黑窗口。它的意思是：

  • 终端（Terminal）：那个黑窗口本身，是运行命令的环境
  • CLI 工具：在终端里运行的具体程序

• 类比一下：终端就像一个舞台，CLI 工具就像演员。git、npm、docker、typeui.sh 都是不同的演员，它们都在同一个舞台上表演。

• 所以当你看到"安装这个 CLI 工具"，意思是往你的终端里加一个新的可用命令，而不是安装一个新的终端。

终端（Terminal）         ← 舞台，系统自带
├── git                 ← 演员：代码版本管理
├── npm / npx           ← 演员：JavaScript 包管理
├── pip                 ← 演员：Python 包管理
├── docker              ← 演员：容器管理
├── typeui.sh           ← 演员：设计系统生成
└── ...                 ← 可以不断加新演员

八、总结

概念	一句话解释
CLI	用打字代替点鼠标来操作电脑
终端 / Terminal	输入命令的那个窗口，系统自带
命令	一行文字 = 工具 + 动作 + 参数
CLI 工具	在终端里运行的特定程序（git、npm 等）
提示符	终端里那行等你输入的文字，告诉你"你在哪"

• 5 个够用的基础命令：

  概念	一句话解释
  CLI	用打字代替点鼠标来操作电脑
  终端 / Terminal	输入命令的那个窗口，系统自带
  命令	一行文字 = 工具 + 动作 + 参数
  CLI 工具	在终端里运行的特定程序（git、npm 等）
  提示符	终端里那行等你输入的文字，告诉你"你在哪"

• 下次再看到技术文章里的命令行，你至少能做到三件事：

  1. 知道这行命令该往哪里输（打开终端）
  2. 能按"工具 + 动作 + 参数"拆解它在干什么
  3. 报错 “command not found” 时知道是缺了工具，去对应官网安装

  CLI 不是什么高深的技术，它只是一种更直接的和电脑对话的方式。你已经会了，只是之前不知道而已。