1. 簡介：為什么使用 Gemini CLI？

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

安裝命令

打開終端（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è)人用戶)：會(huì)自動(dòng)打開瀏覽器彈窗，使用你的 Google 賬號(hào)登錄。

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

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

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

   • Vertex AI：企業(yè)級用戶使用。

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

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

交互模式

直接輸入問題即可：

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

單次命令模式 (Non-interactive)

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

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

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

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

場景 1：解釋 Git 變更

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

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

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

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

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

上下文引用技巧 (@)

這是 Gemini CLI 最核心的技巧。你可以通過 @ 符號(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. 高級配置：項(xiàng)目級上下文 (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。

在里面寫下提示詞（Prompt），例如：

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

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

7. 常見問題排查

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

sudo npm install -g @google/gemini-cli

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

nvm install 20 && nvm use 20

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

Gemini CLI 常用命令速查表

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

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

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

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

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

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

?? 組合使用示例

場景：讓 AI 幫你寫 Git Commit 信息

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

場景：基于特定文件提問

gemini -p "請為 @package.json 文件添加 eslint 依賴"

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

最新評論