Skip to Content
Handbook第 1 章：🛠️ 开发前期准备1.4 开发环境配置指南

1.4 开发环境配置指南

这一节命令多，但别被吓到：按你的系统挑一条路走。先照抄命令，搞不懂就问 AI「这段命令是干嘛的」。

学习策略：不要试图理解每个命令的细节，先按照步骤执行，让环境跑起来。后续使用过程中自然会理解每个命令的作用。

macOS 环境配置

1. 安装 Homebrew

Homebrew 的重要性：Homebrew 让你用一行命令就能安装各种开发软件，不用再去官网下载、拖拽安装。macOS 开发必备。

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

国内网络问题：如果上面的命令太慢或失败，使用清华镜像源安装：

/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install/HEAD/install.sh)"

安装完成后，设置 Homebrew 使用清华源（加速后续软件安装）：

# 替换 Homebrew 源
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
 
# 更新
brew update

终端使用示例

  1. 在 Mac spotlight 中搜索「终端」，打终端
  2. 复制上面的命令，按回车
  3. 提示输入密码的时候，输入密码即可。密码不会显示，输入完按回车即可。输错了按删除键，或者再试一次。
  4. 课程中涉及终端/命令行的，基本都是这样使用。
  5. 单独在「终端」app 中执行命令，和 Cursor、trae 里执行命令，效果都是一样的，只是使用的地方不一样。

用途：一键安装各种开发工具

常用命令：

brew install python       # 安装 Python
brew list                 # 查看已安装的软件
brew update               # 更新 Homebrew
brew upgrade              # 升级已安装的软件

关于 Git：安装 Homebrew 时会自动安装 Xcode Command Line Tools，其中已包含 Git。运行 git --version 确认即可，无需单独安装。

2. 安装 Node.js 和 pnpm

为什么需要 Node.js：Node.js 让你的电脑能运行 JavaScript 代码。现代网站开发离不开它，你写的前端项目都需要 Node.js 来构建和运行。

Node.js 安装

# 通过 Homebrew 安装 Node.js LTS 版本
brew install node
 
# 验证安装
node --version
npm --version

关于 pnpm：npm 是 Node.js 自带的工具，用来下载和管理项目依赖的代码库。pnpm 功能一样但更快、更省空间，强烈推荐。

# 安装 pnpm（推荐）
npm install -g pnpm
 
# 验证安装，显示了版本号，则说明安装成功
pnpm --version

国内网络问题：如果安装太慢或失败，切换到镜像源：

# 设置 npm 使用阿里巴巴提供的镜像源
npm config set registry https://registry.npmmirror.com
 
# 设置 pnpm 使用阿里巴巴提供的镜像源
pnpm config set registry https://registry.npmmirror.com
 
# 验证源是否切换成功
npm config get registry
pnpm config get registry

pnpm vs npm：

  • 安装速度快 2-3 倍
  • 硬盘占用少（共享依赖）
  • 用法几乎一样：npm install → pnpm install

3. 安装配置 GitHub CLI

GitHub CLI 的优势：GitHub CLI (gh) 让你在命令行直接操作 GitHub，无需手动配置 SSH 密钥，一个命令就能登录并完成所有认证。

安装 GitHub CLI

  1. 通过 Homebrew 安装：
brew install gh
  1. 验证安装：
gh --version

登录 GitHub

  1. 开始认证流程：
gh auth login

  1. 按照提示选择：

    • 选择 GitHub.com（不是 Enterprise）
    • 选择 HTTPS（推荐，更简单）
    • 当被问到是否用 Git 凭据认证时，选择 Yes
    • 选择 Login with a web browser

  2. 浏览器认证：

    • 终端会显示一个一次性代码（如 ABCD-1234）
    • 按回车后会自动打开浏览器
    • 在浏览器中输入这个代码
    • 授权 GitHub CLI 访问你的账户

  3. 验证登录成功：

gh auth status

成功提示：如果看到「Logged in to github.com」和你的用户名，说明认证成功！

4. 环境验证

运行以下命令确认所有工具安装成功：

# 检查 Node.js
node --version
 
# 检查 npm
npm --version
 
# 检查 pnpm
pnpm --version
 
# 检查 Git
git --version
 
# 检查 GitHub CLI 认证状态
gh auth status

期望输出：

  • Node.js：v18.x.x 或 v20.x.x 或 v22.x.x
  • npm：9.x.x 或 10.x.x
  • pnpm：8.x.x 或 9.x.x
  • Git：git version 2.x.x
  • GitHub CLI：显示 Logged in to github.com 和你的用户名

macOS 常见问题

问题解决方案
brew command not found重新安装 Homebrew 或重启终端
zsh: command not found检查 ~/.zshrc 配置文件
gh auth login 失败检查网络连接，或尝试 gh auth login --web
GitHub CLI 认证过期运行 gh auth refresh 重新认证
权限被拒绝sudo chown -R $(whoami) /usr/local/lib/node_modules

GitHub CLI 基础操作

实用命令：掌握这些命令，你就能在命令行完成大部分 GitHub 操作。

仓库操作：

# 克隆仓库（比传统方式更简单）
gh repo clone username/repo-name
 
# 创建新仓库
gh repo create my-project --public --source=. --remote=origin
 
# 在浏览器中打开当前仓库
gh repo view --web
 
# 查看仓库信息
gh repo view

代码提交和推送：

# 常规 Git 操作（gh 登录后会自动处理认证）
git add .
git commit -m "你的提交信息"
git push
 
# 第一次推送新分支
git push -u origin main

Pull Request 操作：

# 创建 Pull Request
gh pr create --title "功能描述" --body "详细说明"
 
# 查看 PR 列表
gh pr list
 
# 查看 PR 详情
gh pr view 123
 
# 合并 PR
gh pr merge 123

进阶技巧：使用 gh help 或 gh <command> --help 查看更多选项。GitHub CLI 会随着你的使用越来越顺手。

创建第一个测试项目

实践验证：通过创建一个小项目来验证环境配置是否正确。

# 创建项目目录
mkdir test-project
cd test-project
 
# 初始化 npm 项目
npm init -y
 
# 创建简单文件
echo "console.log('Hello, AI Coding!')" > app.js
 
# 运行测试
node app.js

成功标志：如果看到输出「Hello, AI Coding!」说明你的开发环境配置成功！

环境配置检查清单

完成以下配置和验证：

macOS 用户

  • 安装 Homebrew
  • 安装 Node.js 和 pnpm
  • 安装 GitHub CLI 并完成登录认证
  • 验证所有工具版本
  • 创建并运行测试项目

Windows 用户

  • 安装 Windows Terminal
  • 安装 Node.js 和 pnpm
  • 安装 Git
  • 安装 GitHub CLI 并完成登录认证
  • （可选）安装 WSL2
  • 验证所有工具版本
  • 创建并运行测试项目

重要提醒：环境配置只需要做一次。花时间配置好环境，后续的开发工作会顺畅很多。遇到问题不要慌，99% 的环境问题都有成熟的解决方案。

完成提示：恭喜！你已经拥有了一个完整的开发环境。现在可以专注于学习 AI 编程，而不用担心环境配置问题了。

Last updated on
1.3 必备软件与浏览器插件2.1 工具对比与选择