1.6 开发环境配置指南

这一节命令多，但别被吓到：按你的系统挑一条路走。先照抄命令，搞不懂就问 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

终端使用示例

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

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

常用命令：


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

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 后执行）
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

通过 Homebrew 安装：


brew install gh

验证安装：


gh --version

登录 GitHub

开始认证流程：


gh auth login

按照提示选择：
- 选择 GitHub.com（不是 Enterprise）
- 选择 HTTPS（推荐，更简单）
- 当被问到是否用 Git 凭据认证时，选择 Yes
- 选择 Login with a web browser
浏览器认证：
- 终端会显示一个一次性代码（如 ABCD-1234）
- 按回车后会自动打开浏览器
- 在浏览器中输入这个代码
- 授权 GitHub CLI 访问你的账户
验证登录成功：


gh auth status

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

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

Issues 操作：


# 查看 Issues 列表
gh issue list
 
# 创建新 Issue
gh issue create --title "Bug 描述" --body "详细信息"
 
# 关闭 Issue
gh issue close 123

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

Windows 环境配置

1. 安装 WSL2（Windows Subsystem for Linux）

为什么需要 WSL2：

在 Windows 上运行 Linux
更好的开发体验
兼容性更强

安装步骤

以管理员身份运行 PowerShell：


wsl --install

重启电脑：安装完成后需要重启
启动 WSL：

wsl

更新系统：


sudo apt update && sudo apt upgrade

安装基础工具：


sudo apt install git curl

简化版本：如果你暂时不想折腾 WSL，也可以先用纯 Windows 环境写前端项目，后续再迁移也来得及。

2. 安装 Windows Terminal

下载地址：Microsoft Store 搜索「Windows Terminal」

优势：

支持多标签
支持 WSL
美观易用
支持自定义主题

3. 安装 Node.js 和 Git

直接安装

Node.js：

访问 https://nodejs.org
下载 LTS 版本
一路 Next 安装

Git：

访问 https://git-scm.com
下载 Windows 版本
安装（建议默认选项）

WSL2 中安装（推荐）

安装 Node.js

添加 NodeSource 仓库：


curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

安装 Node.js：


sudo apt install -y nodejs

验证安装：


node -v
npm -v

优势：在 Linux 环境中开发，与服务器环境更接近，减少兼容性问题。

环境验证

基础工具检查

验证步骤：确保所有工具都正确安装并可以使用。

运行以下命令验证


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

期望输出：

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

创建第一个测试项目

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


# 创建项目目录
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 常见问题

问题	解决方案
`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`

Windows 常见问题

问题	解决方案
`wsl command not found`	在 PowerShell 中运行 `wsl --install`
`node command not found`	检查 PATH 环境变量或重新安装
Git 权限问题	配置 Git 凭据管理器
网络连接问题	配置代理或使用国内镜像源

环境配置检查清单

完成以下配置和验证：

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

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