1. 簡(jiǎn)介：為什么使用 Gemini CLI？

Gemini CLI (@google/gemini-cli) 是 Google 推出的開(kāi)源命令行 AI 代理。它不僅是一個(gè)聊天機(jī)器人，更是一個(gè)能通過(guò)終端理解你項(xiàng)目上下文、讀取文件甚至執(zhí)行任務(wù)的開(kāi)發(fā)助手。

主要特點(diǎn)：

• 上下文感知：可以直接讀取本地文件（如 @main.py）。
• 管道支持：可以將其他命令的輸出（如 git diff）直接傳給 Gemini。
• 多模態(tài)：支持理解代碼、文本甚至某些版本中的圖片。

2. 安裝 (Installation)

Gemini CLI 基于 Node.js 構(gòu)建，因此需要先確環(huán)境中有 Node.js。

前置要求

• Node.js: 版本需 v18.0.0 或更高 (建議 v20+)。
• 操作系統(tǒng): Windows, macOS, 或 Linux。

安裝命令

打開(kāi)終端（Terminal / PowerShell / CMD），運(yùn)行以下命令進(jìn)行全局安裝：

npm install -g @google/gemini-cli 

如果你不想全局安裝，也可以使用 npx 臨時(shí)運(yùn)行：

npx @google/gemini-cli 

3. 初始化與認(rèn)證 (Authentication)

安裝完成后，第一次運(yùn)行會(huì)引導(dǎo)你進(jìn)行設(shè)置。

啟動(dòng) CLI：
在終端輸入：

gemini 

1. 選擇認(rèn)證方式：
   CLI 會(huì)提示你選擇認(rèn)證方法，通常有以下幾種：

   • Login with Google (推薦個(gè)人用戶(hù))：會(huì)自動(dòng)打開(kāi)瀏覽器彈窗，使用你的 Google 賬號(hào)登錄。

     • 優(yōu)勢(shì)：免費(fèi)額度（通常每天 1000 次請(qǐng)求，每分鐘 60 次）。

   • Gemini API Key：如果你有 Google AI Studio 的 API Key。

     • 設(shè)置方法：你也可以通過(guò)環(huán)境變量設(shè)置：export GEMINI_API_KEY="你的key"。

   • Vertex AI：企業(yè)級(jí)用戶(hù)使用。

4. 基礎(chǔ)使用 (Basic Usage)

認(rèn)證成功后，你會(huì)進(jìn)入一個(gè)交互式對(duì)話界面（REPL）。

交互模式

直接輸入問(wèn)題即可：

> 幫我寫(xiě)一個(gè) Python 腳本來(lái)抓取網(wǎng)頁(yè)標(biāo)題

單次命令模式 (Non-interactive)

如果你不想進(jìn)入對(duì)話模式，只想快速問(wèn)一個(gè)問(wèn)題，可以使用 -p 參數(shù)：

gemini -p "解釋一下什么是 REST API"

管道操作 (Piping) ??(最強(qiáng)功能)

你可以將終端命令的輸出直接“喂”給 Gemini。

場(chǎng)景 1：解釋 Git 變更

git diff | gemini -p "幫我生成這些代碼變更的 Commit Message" 

場(chǎng)景 2：分析日志錯(cuò)誤

cat error.log | gemini -p "分析這個(gè)日志里的主要錯(cuò)誤原因" 

5. 常用命令與技巧 (Commands & Tips)

在 Gemini CLI 的交互模式中（即輸入 gemini 進(jìn)入后），你可以使用以 / 開(kāi)頭的特殊命令：

上下文引用技巧 (@)

這是 Gemini CLI 最核心的技巧。你可以通過(guò) @ 符號(hào)將文件內(nèi)容直接作為 Context 發(fā)送給 AI。

分析代碼文件：

> 幫我優(yōu)化 @server.js 的代碼結(jié)構(gòu) 

Gemini 會(huì)自動(dòng)讀取 server.js 的內(nèi)容并基于此回答。

多文件關(guān)聯(lián)：

> @package.json 和 @Dockerfile 之間有什么版本沖突嗎？ 

6. 高級(jí)配置：項(xiàng)目級(jí)上下文 (GEMINI.md)

如果你希望 Gemini 在進(jìn)入某個(gè)項(xiàng)目文件夾時(shí)，自動(dòng)知道這個(gè)項(xiàng)目的背景（比如“這是一個(gè) React 項(xiàng)目，使用 TypeScript，風(fēng)格要求嚴(yán)格”），你可以創(chuàng)建一個(gè) GEMINI.md 文件。

在項(xiàng)目根目錄新建文件 GEMINI.md。

在里面寫(xiě)下提示詞（Prompt），例如：

# 項(xiàng)目上下文
這是一個(gè)電商后臺(tái)管理系統(tǒng)。
- 前端：Vue 3 + Vite
- 語(yǔ)言：TypeScript
- 只有在這一行明確要求時(shí)才生成測(cè)試代碼。

當(dāng)你在這個(gè)目錄下運(yùn)行 gemini 時(shí)，它會(huì)自動(dòng)加載這個(gè)文件的內(nèi)容作為系統(tǒng)提示詞 (System Prompt)。

7. 常見(jiàn)問(wèn)題排查

權(quán)限報(bào)錯(cuò) (EACCES)：
如果在 Linux/macOS 上安裝失敗，可能需要 sudo：

sudo npm install -g @google/gemini-cli

Node 版本過(guò)低：
如果報(bào)錯(cuò)提示 SyntaxError 或版本不支持，請(qǐng)使用 nvm 升級(jí) Node.js：

nvm install 20 && nvm use 20

希望這篇教程能幫你快速上手！你可以現(xiàn)在就打開(kāi)終端輸入 gemini 試試看。

Gemini CLI 常用命令速查表

1. 終端命令行參數(shù) (Shell Arguments)

這些命令直接在你的系統(tǒng)終端（Terminal/PowerShell）中執(zhí)行。

2. 交互模式指令 (REPL Commands)

這些命令僅在進(jìn)入 gemini 交互界面后使用（輸入時(shí)通常有自動(dòng)補(bǔ)全）。

3. 上下文與特殊語(yǔ)法 (Context Syntax)

在交互模式或 -p 參數(shù)中均可使用的特殊技巧。

?? 組合使用示例

場(chǎng)景：讓 AI 幫你寫(xiě) Git Commit 信息

git diff | gemini -p "根據(jù)這些變更生成一個(gè)簡(jiǎn)潔的 commit message"

場(chǎng)景：基于特定文件提問(wèn)

gemini -p "請(qǐng)為 @package.json 文件添加 eslint 依賴(lài)"

到此這篇關(guān)于Gemini CLI 終極使用小結(jié)的文章就介紹到這了,更多相關(guān)Gemini CLI 使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論