Gemini CLI初体验：除了聊天，用它快速生成代码和文档的5个实用命令
Gemini CLI实战指南：解锁命令行AI助手的5个高效场景
在开发者工具链中，命令行界面（CLI）始终扮演着关键角色。而如今，AI技术的融入让CLI工具焕发出全新活力。Gemini CLI作为一款基于Google Gemini模型的命令行AI工具，正在重新定义开发者与终端交互的方式。与那些仅提供简单问答功能的AI工具不同，Gemini CLI真正将AI能力无缝集成到开发工作流中，从代码生成到文档编写，从命令解释到技术审查，它都能提供实质性的效率提升。
1. 代码片段生成：告别重复性编码
在日常开发中，我们经常需要编写一些重复性的代码结构，比如React组件模板、数据库连接配置或是API请求封装。Gemini CLI能够理解你的需求，快速生成可立即使用的代码片段。
gemini generate "创建一个使用axios的React自定义hook，用于处理GET请求，包含加载状态和错误处理"执行上述命令后，Gemini CLI会输出一个完整的自定义hook实现：
import { useState, useEffect } from 'react'; import axios from 'axios'; function useApiGet(url) { const [data, setData] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { const fetchData = async () => { try { const response = await axios.get(url); setData(response.data); } catch (err) { setError(err.message || '请求失败'); } finally { setLoading(false); } }; fetchData(); }, [url]); return { data, loading, error }; } export default useApiGet;实用技巧：
- 指定语言：在请求中明确语言，如"用Python编写..."
- 包含依赖：要求"使用pandas库实现..."
- 风格偏好："遵循Google Java风格指南..."
提示：生成的代码应始终进行人工审查，特别是涉及安全敏感操作时
2. 技术文档自动化：从代码到文档的无缝转换
编写技术文档是开发过程中不可或缺但常常被忽视的环节。Gemini CLI能够分析你的代码并生成相应的文档草稿，大幅减少文档编写时间。
gemini document --file=src/utils/auth.js --format=markdown这个命令会读取指定的JavaScript文件，并输出结构清晰的Markdown格式文档：
# auth.js 模块文档 ## 功能概述 提供用户认证相关的工具函数，包括： - JWT令牌生成与验证 - 密码哈希处理 - 权限校验 ## 函数列表 ### `generateToken(userId, role)` - **参数**: - `userId`: string - 用户唯一标识符 - `role`: string - 用户角色(admin/user/guest) - **返回值**: string - 签名的JWT令牌 - **示例**: ```javascript const token = generateToken('12345', 'admin'); ``` ### `verifyToken(token)` - **参数**: - `token`: string - 待验证的JWT令牌 - **返回值**: object - 解码后的令牌内容或抛出错误文档生成最佳实践：
| 选项 | 描述 | 适用场景 |
|---|---|---|
| --format=markdown | 生成Markdown格式 | GitHub/GitLab文档 |
| --format=html | 生成HTML片段 | 网页集成 |
| --level=detail | 包含详细实现说明 | 内部开发文档 |
| --level=overview | 仅概要描述 | API参考文档 |
3. 复杂命令解释与学习
遇到不熟悉的命令行工具或复杂命令组合时，Gemini CLI可以充当实时解释器，帮助开发者理解每个参数和选项的作用。
gemini explain "find . -name '*.js' -exec grep -l 'useState' {} + | xargs wc -l"Gemini CLI会返回详细的逐段解释：
这个复合命令执行以下操作：
find . -name '*.js'- 在当前目录(.)及子目录中查找所有.js文件
-exec grep -l 'useState' {} +- 对找到的每个文件，执行grep查找'useState'字符串
-l选项只输出包含匹配项的文件名{}是find命令的占位符，表示当前文件+表示一次传递多个文件名给grep
| xargs wc -l- 将匹配的文件列表通过管道传递给xargs
- xargs将这些文件名作为参数传递给wc(字数统计)
-l选项让wc只统计行数
最终效果：统计所有包含React useState hook的JavaScript文件的行数
学习建议：
- 使用
gemini explain --interactive进入交互模式 - 尝试分解复杂命令逐步理解
- 要求提供替代方案比较："与使用grep -r相比..."
4. 代码审查与优化建议
Gemini CLI可以充当第一轮代码审查员，帮助发现潜在问题并提出改进建议，特别适合在提交PR前进行快速自查。
gemini review --file=src/components/DataTable.js --lang=javascript典型输出可能包括：
## DataTable.js 审查报告 ### 优点 - 良好的组件化结构 - 合理的prop-types定义 - 使用了Memo优化渲染性能 ### 改进建议 1. **性能优化** - 第45行: 内联箭头函数作为prop会导致不必要的重新渲染 ```javascript // 当前 <Row onClick={() => handleSelect(item.id)} /> // 建议 const onRowClick = useCallback((id) => () => handleSelect(id), [handleSelect]); ``` 2. **可读性提升** - 第78-92行: 复杂的数据转换逻辑可提取为独立工具函数 - 考虑添加JSDoc注释说明转换规则 3. **错误处理** - 缺少对空数据或异常API响应的处理 - 建议添加默认空状态和错误边界审查深度控制选项：
| 级别 | 检查内容 | 适用场景 |
|---|---|---|
| basic | 语法、明显错误 | 快速检查 |
| standard | 性能、最佳实践 | 日常审查 |
| strict | 安全性、架构 | 关键代码审查 |
5. 工作流自动化：创建自定义AI脚本
Gemini CLI的真正强大之处在于能够将AI能力集成到你的自动化脚本中。通过创建自定义命令别名和脚本，你可以打造个性化的AI增强工作流。
示例1：创建Git提交消息生成器
alias gai-commit='git diff --cached | gemini generate "基于以下代码变更，编写简洁专业的Git提交消息，遵循常规提交规范。变更内容："'使用方式：
git add你的变更- 运行
gai-commit - Gemini CLI会生成类似如下的提交消息：
feat(auth): 添加JWT令牌刷新功能 - 实现refreshToken中间件 - 添加令牌过期时间检查 - 更新相关API文档
示例2：建立日常待办事项生成系统
gemini automate --setup <<EOF # 保存为 ~/.gemini/scripts/daily_plan.sh #!/bin/bash echo "根据以下信息生成今日开发计划：" echo "- 当前Git分支: \$(git branch --show-current)" echo "- 最近提交: \$(git log -1 --pretty=%B)" echo "- 待处理PR数量: \$(gh pr list --json=title | jq length)" EOF之后只需运行：
gemini run daily_plan常用自动化场景：
- 会议纪要生成（基于git变更和issue讨论）
- 技术决策记录辅助
- 定期报告自动生成
- 错误日志分析与摘要
提升Gemini CLI使用体验的进阶技巧
要让Gemini CLI真正成为你的开发助手，而不仅仅是偶尔使用的工具，需要一些定制化和习惯培养。
配置优化：
# ~/.gemini/config.yaml defaults: language: typescript codeStyle: airbnb tone: professional detailLevel: balanced上下文保持会话：
gemini chat --context=current进入交互模式后，Gemini CLI会记住之前的对话内容，适合复杂问题的分步讨论。
输出格式化控制：
| 选项 | 效果 | 使用场景 |
|---|---|---|
| --wrap=80 | 文本换行 | 终端阅读 |
| --no-color | 禁用语法高亮 | 日志记录 |
| --raw | 原始输出 | 管道处理 |
性能调优：
- 使用
--stream选项处理大输出 - 设置
GEMINI_CACHE_DIR缓存常见响应 - 通过
--temperature控制创意性（0.2-1.0）
在持续使用Gemini CLI几周后，大多数开发者会发现：
- 重复性编码任务时间减少40-60%
- 文档编写时间缩短50%以上
- 学习新工具/框架的速度显著提升
- 代码质量因即时审查而提高