1.6 开发环境配置指南

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

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

macOS 环境配置

1. 安装 Homebrew（包管理工具）

Homebrew 的重要性：Homebrew 是 macOS 上最流行的包管理工具，能让你用一个命令安装各种开发软件。


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

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

常用命令：


brew install git          # 安装 Git
brew install node         # 安装 Node.js
brew install python       # 安装 Python
brew list                 # 查看已安装的软件
brew update               # 更新 Homebrew
brew upgrade              # 升级已安装的软件

完成标志：执行完这一步，其实就能开始写代码。后面的 iTerm2、Oh My Zsh 完全是锦上添花。

2. 配置终端（可选）

可选项目：如果你的开发需求不高，可以跳过这一步。但配置好的终端能显著提升开发体验。

安装 iTerm2


brew install --cask iterm2

优势：

支持分屏
更好的搜索功能
自定义主题
快捷键支持

安装 Oh My Zsh


sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

推荐主题：


# 编辑配置文件
nano ~/.zshrc
 
# 修改主题
ZSH_THEME="robbyrussell"

常用主题：

robbyrussell：默认主题，简洁
agnoster：显示更多信息
powerlevel10k：功能强大的主题

3. 配置 SSH 密钥（用于 GitHub）

SSH 密钥的重要性：配置 SSH 密钥后，你可以免密码向 GitHub 推送代码，这是专业开发的必备技能。

生成 SSH 密钥

生成新密钥：


ssh-keygen -t ed25519 -C "[email protected]"

复制公钥：


cat ~/.ssh/id_ed25519.pub

添加到 GitHub：
- 访问 https://github.com/settings/keys
- 点击「New SSH key」
- 粘贴公钥
- 保存
测试连接：


ssh -T [email protected]

成功提示：如果看到 “Hi yourname! You’ve successfully authenticated” 说明配置成功。

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
 
# 检查 SSH 密钥
ssh -T [email protected]

期望输出：

Node.js：v18.x.x 或 v20.x.x
npm：9.x.x 或 10.x.x
Git：git version 2.x.x
SSH：成功连接 GitHub

创建第一个测试项目

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


# 创建项目目录
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 配置文件
SSH 连接失败	检查密钥是否正确添加到 GitHub
权限被拒绝	`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 编程，而不用担心环境配置问题了。