跳转到内容

通用环境基础设施

起步

内容验证于 2026-06-24

本教程属于学习路径: · 浏览全部路径

AI 编程工具都需要你使用终端输入命令。如果你以前只点鼠标操作电脑,这篇文章帮你补齐基础知识。读完你会知道终端是什么、怎么打开、以及安装软件时经常出现的“PATH”“环境变量”是什么意思。

不需要任何预备知识。这正是零基础起点。

你的电脑像一个厨房。GUI(鼠标点来点去)就是在厨房台面上手动切菜、炒菜。终端(Terminal)就是你对厨师长用对讲机下命令——更快、更精确,但你得知道正确的口令。PATH 就是厨师长的菜单——他只听上面列的那些厨师的指令。

  • macOS:按 Cmd + Space,输入 Terminal,回车。或 Launchpad → 其他 → 终端
  • Windows:按 Win + R,输入 cmdpowershell,回车
  • Linux:取决于桌面环境,通常是 Ctrl + Alt + T
Terminal window
echo "Hello"

输出:Hello

echo 就是“复读机”——你说什么它就重复什么。

Terminal window
pwd

输出:类似 /Users/jason 的路径。pwd = “print working directory”(打印当前目录)。

Terminal window
ls

输出:当前目录下的文件列表。ls = “list”(列出)。

包管理器就是一个“应用商店”,只是工作在终端里:

  • macOSbrew install <包名>(需要先装 Homebrew)

如果你的 Mac 还没装 Homebrew(输入 brew --version 看是否提示 command not found),先用这条命令安装:

Terminal window
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程中它会告诉你它在做什么、是否需要输入密码。按提示操作即可。装完后验证:brew --version

  • Windowswinget install <包名>(Windows 11 自带)
  • Linuxsudo apt install <包名>(Debian/Ubuntu)或 sudo dnf install <包名>(Fedora)
Terminal window
echo $PATH

输出:一串用 : 分隔的目录路径。

当你输入 npm 时,系统按照 PATH 里列出的目录顺序去找 npm 这个可执行文件。如果找不到,就报 command not found

Terminal window
echo $HOME

输出:你的用户主目录路径(如 /Users/jason)。

环境变量是系统和程序之间共享的“便签”。HOME 告诉所有程序你的主目录在哪。AI 工具的 API Key 通常也通过环境变量传入(如 ANTHROPIC_API_KEY)。

  • command not found:这个命令没有安装,或者它的路径不在 PATH 里。先确认已安装:which <命令名>。若安装了仍提示 command not found,大概率 PATH 未包含该安装路径。
  • Permission denied:没有权限。加 sudo 尝试(macOS/Linux),或检查文件权限:chmod +x <文件名>
  • 安装完软件后终端不识别:关掉终端重新打开。新装的软件注册到 PATH 需要重启 shell 才能生效。

确认你的环境已就绪:

  1. 打开终端,输入 echo "Hello" 能看到输出
  2. 输入 node --version 能看到版本号(没有?macOS 运行 brew install node,Windows 运行 winget install OpenJS.NodeJS.LTS
  3. 输入 npm --version 能看到版本号
  4. 你知道 pwd 是干什么的(打印当前目录)

全部通过?环境就绪,可以继续了。