跳到主要内容
版本：2025年夏季她行活动

基础教程：环境准备与工具安装

学习目标

完成本章学习后，您将能够：

  • 成功注册所需的开发账号
  • 在本地安装并配置 Gemini CLI
  • 使用 AI 管理您的开发环境
  • 掌握基本的 AI 辅助开发流程
观看视频演示

课程一与课程二的完整教学视频已迁移到本期项目的视频教程总页，方便你在一个地方找到所有教学视频。

必备账号注册​

在开始使用 Gemini CLI 之前，我们需要准备三个重要的账号。这些账号将贯穿整个开发流程。

为什么需要 GitHub？​

GitHub 是全球最大的代码托管平台，我们将用它来：

  • 存储和管理代码
  • 与他人协作开发
  • 展示个人项目作品集

注册步骤​

  1. 访问 GitHub.com
  2. 点击右上角的 "Sign up"
  3. 填写注册信息：
    • Username：选择一个专业的用户名（建议使用真实姓名或昵称）
    • Email：使用常用邮箱
    • Password：设置强密码
专业建议

选择用户名时要慎重，因为它将出现在您所有的项目 URL 中。建议使用：

  • 真实姓名：john-smith
  • 专业昵称：webdev-pro
  • 避免使用数字结尾：coder123

初始配置​

注册完成后，建议完成以下配置：

# 配置 Git 全局用户信息
git config --global user.name "您的姓名"
git config --global user.email "[email protected]"

Gemini CLI 安装配置​

系统要求​

最低要求：

  • Windows 10 版本 1903 或更高
  • Node.js 16.0 或更高版本
  • 4GB RAM（推荐 8GB）

推荐配置：

  • Windows 11
  • Node.js 18.x LTS
  • 使用 Windows Terminal

安装步骤​

步骤 1：检查 Node.js 版本​

# 检查 Node.js 是否已安装
node --version

# 如果未安装或版本过低，请访问 nodejs.org 下载安装

步骤 2：全局安装 Gemini CLI​

# 使用 npm 安装（推荐）
npm install -g @google/gemini-cli

# 或使用 yarn
yarn global add @google/gemini-cli

# 或使用 pnpm
pnpm add -g @google/gemini-cli
安装提示

如果遇到权限问题，请：

  • Windows：以管理员身份运行命令提示符
  • macOS/Linux：使用 sudo npm install -g @google/gemini-cli

步骤 3：验证安装​

# 检查安装是否成功
gemini --version

# 查看可用命令
gemini --help

首次配置​

安装完成后，需要进行初始配置：

# 1. 登录 Google 账号
gemini auth login

# 2. 系统将打开浏览器，请登录您的 Google 账号
# 3. 授权 Gemini CLI 访问必要的权限
# 4. 返回终端，您应该看到 "Successfully authenticated!" 的提示

配置选项​

# 设置默认项目路径
gemini config set default-path ~/projects

# 设置语言偏好
gemini config set language zh-CN

# 查看当前配置
gemini config list

基础使用示例​

您的第一次对话​

现在让我们开始使用 Gemini CLI。

# 启动交互式对话
gemini chat

# Gemini 会回应：
# "你好！我是 Gemini，您的 AI 编程助手。有什么可以帮助您的吗？"

实用对话示例​

环境配置​

您：你好，我想开发web应用，请问我需要安装哪些必须的开发环境？

Gemini：我来帮您配置 Web 开发环境。建议安装以下工具：

1. Node.js 和 npm - JavaScript 运行环境
2. VS Code - 代码编辑器
3. Git - 版本控制
4. Chrome DevTools - 调试工具

需要我帮您自动安装这些工具吗？

依赖管理​

您：请帮我检查本地有哪些 Node.js 全局包，并建议哪些可以删除

Gemini：正在扫描您的全局 npm 包...

找到以下包：
- create-react-app (v4.0.3) - 建议删除，使用 npx 代替
- nodemon (v2.0.15) - 保留，开发常用
- typescript (v4.5.2) - 建议删除，项目级安装更好
- pm2 (v5.1.0) - 保留，进程管理工具

需要我帮您清理这些包吗？

PATH 管理​

您：帮我查看并整理系统 PATH

Gemini：检测到您的 PATH 中有以下条目：

重复项：
- /usr/local/bin (出现 3 次)
- ~/.npm-global/bin (出现 2 次)

无效路径：
- /opt/old-software/bin (不存在)

建议优化后的 PATH 顺序：
1. ~/.local/bin
2. /usr/local/bin
3. ~/.npm-global/bin
4. /usr/bin

要应用这些更改吗？

告别繁琐的传统方式​

不再需要的工具​

传统工具被 Gemini CLI 替代的原因
Cursor中国大陆锁区；Pro 额度性价比低；Gemini CLI 完全免费可用
GitHub Desktop无需 GUI 工具；Gemini 可以执行所有 Git 操作；更灵活的命令行交互
Git 命令不用记忆任何 Git 命令；自然语言描述即可；AI 自动处理复杂操作

新旧对比​

您：提交我的更改，描述是"添加了新功能"
Gemini：好的，我帮您提交更改...
[执行 git add, commit, push]
成功提交到 main 分支

您：有冲突了，帮我解决
Gemini：检测到合并冲突，我来帮您：
1. 分析冲突文件...
2. 基于代码逻辑建议解决方案...
3. 要接受我的建议吗？

您：查看最近的提交历史
Gemini：最近 5 次提交：
- 2分钟前: 添加了新功能 (您)
- 1小时前: 修复了登录问题 (张三)
- 3小时前: 更新了文档 (李四)
...

最佳实践建议​

日常工作流程​

  1. 每日开始

    您：早上好，帮我检查项目状态
    Gemini：为您检查项目状态...

  2. 开发过程

    您：我要开始开发用户认证功能
    Gemini：我来帮您准备...

  3. 问题解决

    您：npm install 报错了，帮我看看
    Gemini：我来分析错误...

效率提升技巧​

  • 明确表达：清晰描述您的需求，AI 会更准确地帮助您
  • 持续对话：保持上下文，让 AI 更好地理解您的项目
  • 善用历史：使用 gemini history 查看之前的对话

下一步​

恭喜您完成了基础环境的配置。现在您已经拥有了：

  • 三个必要的开发账号
  • 本地安装的 Gemini CLI
  • AI 辅助开发的基础知识

继续学习实践项目