AI Coding 零基础实战教程｜第零部分：环境准备与工具安装

第零部分：环境准备与工具安装

学习目标：搭建完整的开发环境，确保后续学习零障碍

完成标志：能在终端执行基本命令，至少一个AI编程工具可正常运行

工欲善其事，必先利其器。在正式进入AI编程世界之前，我们需要先把"工作台"搭好。这就像做菜之前先把厨房收拾好、食材买齐 ------ 虽然不是最激动人心的环节，但跳过它后面会处处碰壁。

0.1 终端/命令行入门：你的AI编程控制台

0.1.1 什么是终端

你平时用电脑，是通过鼠标点击图标、菜单来操作的，这叫图形界面（GUI）。而**终端（Terminal）**是另一种操作电脑的方式 ------ 通过输入文字命令来告诉电脑做什么。

打个比方：图形界面就像在餐厅看着菜单点菜（点什么有什么），终端就像直接跟厨师说你想吃什么（更灵活，但需要知道怎么"说"）。

AI编程工具（如Claude Code）几乎全部运行在终端中，所以掌握基本的终端操作是第一步。

0.1.2 如何打开终端

Windows 用户：

按下键盘上的 Win + R 键（Win 是键盘左下角带 Windows 标志的键）
在弹出的"运行"对话框中输入 powershell
按回车键

或者更简单的方式：

在桌面底部的搜索栏中搜索"PowerShell"
点击"Windows PowerShell"打开

macOS 用户：

按下 Command + 空格 打开 Spotlight 搜索
输入 Terminal 或"终端"
按回车键打开

提示：打开终端后你会看到一个黑色（或白色）的窗口，里面有一个闪烁的光标等待你输入命令。不要怕，它不会因为你输错命令就爆炸 ------ 最多给你一个报错信息而已。

0.1.3 5个必会终端命令

以下是你需要掌握的最基本的终端命令。打开终端，跟着一起敲：

1. pwd ------ 查看当前位置（我在哪？）

bash 复制代码

# 通用命令（macOS/Linux直接输入，Windows PowerShell也支持）
$ pwd

预期输出：

复制代码

# Windows 输出类似：
C:\Users\你的用户名

# macOS 输出类似：
/Users/你的用户名

这就像你在商场里，看一下脚下的地图上"您在此处"的标记。

2. ls（macOS/Linux）或 dir（Windows）------ 查看当前目录有什么

bash 复制代码

# macOS / Linux
$ ls

# Windows PowerShell（ls也可以用，但dir是经典命令）
$ dir

预期输出：

复制代码

Desktop    Documents   Downloads   Pictures   Videos
桌面       文档       下载       图片      视频

就像打开一个文件夹，看看里面有什么东西。

3. cd ------ 进入某个目录（走到某个位置）

bash 复制代码

# 进入"桌面"文件夹
$ cd Desktop

# 返回上一级目录
$ cd ..

# 直接回到用户主目录
$ cd ~

cd 是 "change directory" 的缩写，就是"换个地方"的意思。

4. mkdir ------ 创建新文件夹

bash 复制代码

# 创建一个名为 my-project 的文件夹
$ mkdir my-project

# 验证：查看是否创建成功
$ ls

预期输出中应该能看到 my-project 文件夹。

5. clear ------ 清屏（屏幕太乱了，清理一下）

bash 复制代码

$ clear

验证：在终端中依次执行以下命令，确认你能正常操作：
bash 复制代码
$ pwd
$ mkdir ai-coding-test
$ cd ai-coding-test
$ pwd
$ cd ..
如果每条命令都能正常执行且没有报错，恭喜你，终端入门完成！

0.1.4 常见问题

问题	原因	解决方案
命令输入后提示"不是内部或外部命令"	命令拼写错误或该命令不存在	检查拼写，注意大小写
中文路径导致命令失败	某些工具不支持中文路径	使用全英文路径名，如 `D:\projects`
PowerShell 窗口闪退	可能被系统策略限制	右键以管理员身份运行

注意：在整个教程中，请尽量使用全英文的文件夹名和文件名。中文路径在很多开发工具中会引发奇怪的错误，这是一个经典的坑。

0.2 开发环境安装

0.2.1 Node.js 安装

Node.js 是一个让 JavaScript 能在电脑上运行的环境。它是前端开发、npm 包管理、Next.js/Vite 项目的基础工具，也是 Claude Code 官方安装前置条件之一。

你可以把 Node.js 理解为 AI 编程项目的"基础运行环境"：很多脚手架、依赖安装、构建命令都离不开它。

下载安装：

打开浏览器，访问 Node.js 官网：https://nodejs.org/
你会看到两个版本按钮，选择左边的 LTS（长期支持版），这是最稳定的版本
下载完成后，双击安装包
安装过程中一路点 "Next"（下一步），保持默认选项即可
最后点 "Install" 完成安装

注意：安装时请确保勾选了"Add to PATH"选项（默认是勾选的），这样才能在终端中直接使用 node 和 npm 命令。

验证安装：

安装完成后，关闭并重新打开终端（这一步很重要，否则新安装的命令可能找不到），然后输入：

bash 复制代码

# 检查 Node.js 版本
$ node -v

预期输出：

复制代码

v24.15.0

（版本号可能不完全一致。建议安装官网当前 LTS 版本；如果用 npm 安装 Claude Code，需要 Node.js v18 或更高版本。）

bash 复制代码

# 检查 npm 版本（npm 是 Node.js 自带的包管理器）
$ npm -v

预期输出：

复制代码

11.12.1

验证：如果两条命令都能输出版本号，恭喜，Node.js 安装成功！

常见问题：

问题	原因	解决方案
`node: command not found` 或 "不是内部命令"	Node.js 未添加到系统 PATH	重新安装并确保勾选 "Add to PATH"；或手动将 Node.js 安装目录添加到系统环境变量
版本低于 v18	下载了旧版本	重新到官网下载最新的 LTS 版本
安装过程报错（Windows）	权限不足	右键安装包 → "以管理员身份运行"
macOS 提示"无法验证开发者"	macOS 安全限制	系统偏好设置 → 安全性与隐私 → 仍要打开

提示：如果你是 macOS 用户，推荐使用 nvm（Node Version Manager）来管理 Node.js 版本，方便将来切换不同版本。安装命令：
bash 复制代码
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
安装完成后重启终端，然后使用 nvm install --lts 安装最新 LTS 版本。

0.2.2 Git 安装与配置

Git 是一个"版本控制"工具。什么是版本控制？想象你在写一篇文章，每写一个版本你都存一份副本：论文_v1.doc、论文_v2.doc、论文_最终版.doc、论文_最终最终版.doc...... Git 就是帮你优雅地管理这些版本的工具。

在AI编程中，Git 尤其重要 ------ 因为AI有时候会改错代码。有了 Git，你可以随时"时光倒流"回到之前正确的版本。这是你的"后悔药"。

下载安装：

Windows 用户：

访问 https://git-scm.com/download/win
下载 64-bit 版本的安装包
双击安装，安装过程中保持所有默认选项即可（会有很多页配置，不用改，一直点 Next）
安装完成

macOS 用户：

macOS 通常自带 Git。打开终端输入 git --version，如果有输出就不需要安装。如果没有，执行：

bash 复制代码

# macOS 安装 Git（通过 Xcode 命令行工具）
$ xcode-select --install

弹出的对话框中点击"安装"即可。

验证安装：

bash 复制代码

$ git --version

预期输出：

复制代码

git version 2.43.0

首次配置（必须）：

安装完成后，需要告诉 Git 你是谁（这些信息会记录在每次代码提交中）：

bash 复制代码

# 设置你的名字（用英文，可以是昵称）
$ git config --global user.name "Your Name"

# 设置你的邮箱
$ git config --global user.email "your.email@example.com"

提示：这里的名字和邮箱不需要是真实的，但建议和你将来注册 GitHub 的邮箱保持一致。

Git 最小生存技能（6条命令走天下）：

你现在不需要精通 Git，只要记住这6条命令就够了（后面遇到会详细解释）：

bash 复制代码

# 1. 在项目文件夹中初始化 Git 仓库（只需要做一次）
$ git init

# 2. 查看当前文件状态（哪些文件被修改了）
$ git status

# 3. 把修改的文件添加到"暂存区"（准备提交）
$ git add .

# 4. 提交一个版本（附带说明信息）
$ git commit -m "描述这次修改做了什么"

# 5. 将代码推送到远程仓库（如GitHub）
$ git push

# 6. 从远程仓库拉取最新代码
$ git pull

避坑：使用AI编程工具时，养成一个好习惯 ------ 在让AI做大的修改之前，先 git add . && git commit -m "保存当前进度" 。这样即使AI改坏了，你也能用 git checkout . 恢复到之前的状态。这是无数开发者总结出的血泪经验。

0.2.3 Python 安装（可选）

Python 在本教程的第六部分（AI知识库项目）中会用到。如果你暂时只想学前端项目，可以先跳过。

下载安装：

访问 https://www.python.org/downloads/
下载最新版本（建议 Python 3.11 或 3.12）
Windows 用户特别注意 ：安装时务必勾选 "Add Python to PATH" 选项！

验证安装：

bash 复制代码

# Windows
$ python --version

# macOS / Linux（可能需要用 python3）
$ python3 --version

预期输出：

复制代码

Python 3.12.4

bash 复制代码

# 验证 pip（Python 包管理器）
$ pip --version

预期输出：

复制代码

pip 24.0 from ... (python 3.12)

0.3 环境验证：确认一切就绪

完成上面的安装后，让我们做一次全面的环境检查，确保所有工具都正常工作。

环境检查清单：

打开终端，依次执行以下命令：

bash 复制代码

# 1. 检查 Node.js
$ node -v
# 预期输出: v18.x.x 或更高版本

# 2. 检查 npm
$ npm -v
# 预期输出: 9.x.x 或 10.x.x 或更高版本

# 3. 检查 Git
$ git --version
# 预期输出: git version 2.x.x

# 4. 检查 Python（可选）
$ python --version
# 预期输出: Python 3.11.x 或 3.12.x

创建你的第一个项目文件夹：

bash 复制代码

# 在你喜欢的位置创建一个总的工作目录
# Windows 建议：
$ mkdir D:\ai-coding-projects

# macOS 建议：
$ mkdir ~/ai-coding-projects

# 进入这个目录
$ cd D:\ai-coding-projects  # Windows
$ cd ~/ai-coding-projects   # macOS

# 初始化 Git
$ git init

预期输出：

复制代码

Initialized empty Git repository in .../ai-coding-projects/.git/

验证：如果以上所有命令都能正常执行，恭喜你！环境准备工作全部完成。你现在拥有了进入AI编程世界的全部工具。

环境准备完成度检查表：

Node.js 已安装，版本 >= 18
npm 已安装
Git 已安装并完成基本配置（user.name 和 user.email）
已创建工作目录并初始化 Git

如果有某一项未完成，请回到对应章节重新操作。不要跳过这些步骤 ------ 后续每一步都依赖这些基础环境。