- 适合分析长文档、代码项目、会议记录、PDF、MD、JSON、JS 等等
- 免费额度多：每分钟 60 次，100万token超长记忆，日常学习 & 私项目足够了
- 可选结果格式，如 JSON / Markdown / Summary
学会 Gemini CLI + 项目目录 + prompt 写法，你就能让 AI 成为你真正的副驾工程师，不用一句句再问，而是直接“看整个项目、理解上下文、自动建议+修改”，效率暴涨💥
用最简单、最直白的方式入门 Gemini CLI 自动改代码的流程：
🧭 第一步：确认你能用 Gemini CLI
🔧先安装 nodejs 18或以上，npx https://github.com/google-gemini/gemini-cli 或使用以下命令安装：
npm install -g @google/gemini-cli
gemini🔧官方文档：
🔧快速确认一下在终端输入：
gemini --help
如果你看到一串命令说明，比如 analyze、chat、code 等，就说明已经准备好啦。
如果提示 command not found，我们再单独安装（可跳过这步）。
📁 第二步：理解项目目录结构
Gemini 是“看目录”的，所以你得知道你现在在哪个目录下。例如你当前在博客项目：
astro-blog/
├── public/
├── src/
│ ├── components/
│ ├── layouts/
│ ├── pages/
│ └── styles/
├── package.json
└── astro.config.mjs
我们重点关注 src/ 这个目录。假设你想优化首页 /src/pages/index.astro 的结构。
✍️ 第三步：写 prompt（中英文都可以）
Prompt 就是你想让 Gemini 做什么的“说明书”。
✅ Prompt 范例（中文）：
请优化首页 index.astro 的视频加载逻辑，实现：
1. 加载前显示封面图
2. 视频懒加载并自动播放
3. 增加一个暗色滤镜的入场动画
✅ Prompt 范例（英文）：
Please refactor index.astro to:
1. Show a fallback image before video loads
2. Enable lazy loading and autoplay
3. Add a dark color filter with fade-in animation
🧪 第四步：运行命令（开始 AI 代码编辑）
🎯 目标：改首页的 index.astro 页面
在终端中输入：
gemini edit ./src/pages/index.astro \
--goal "Refactor the page to lazy-load video with a cover image and add a dark filter animation"
它会：
- 读取 index.astro
- 根据你的目标分析代码
- 输出修改后的版本（有时是整个文件，有时是 patch）
💾 第五步：保存 or 应用结果
你会看到 Gemini 给你返回的代码。
你可以：
- 复制粘贴回你的项目里
- 或者用
-output参数让它生成文件：
gemini edit ./src/pages/index.astro \
--goal "..." \
--output ./_gemini_suggestions/index.astro
这样不会破坏原文件，你可以自己对比。
✅ 进阶玩法（一次看多个文件）
你也可以喂它整个目录，比如：
gemini chat --context ./src/pages \
--goal "优化所有页面的视频加载方式，统一为懒加载 + fallback 封面图"
或者：
gemini explain ./src/components \
--goal "解释这个 Astro 博客中组件的结构关系"
🧠 第六步：如何写好 prompt？
建议用“任务清单”格式：
✨动词 + 目标 + 限定条件
例子：
- 「把页面的导航栏提取成独立组件，命名为
Header.astro」 - 「将所有
/blog/*页面中的 Markdown 结构统一成标准格式」 - 「为
src/utils/seo.ts添加生成 og:image 的逻辑」
英文也一样写法：
- "Extract the navbar into a
Header.astrocomponent" - "Add dark mode toggle to all pages"
- "Optimize
scripts/loader.tsto avoid blocking rendering"
❤️ 想试试的话，给个目标，帮你写命令
比如你说：
「我想让它优化 Astro 博客的加载速度」「我想把所有 blog 页面抽成模板」
gemini refactor ./src/pages/blog \
--goal "Refactor blog pages into a reusable layout component with faster image loading"
Gemini CLI 和项目目录 + prompt 的组合，就是设计师-开发者混合体的终极武器。你动动脑，它动手干。
踩坑问题
权限不足，提示我只能访问c盘的用户目录，没有用管理员权限
你可能是在非管理员权限下运行 CMD 或 PowerShell，这会导致 Gemini CLI 无法访问某些磁盘路径（尤其是 D:\ 下的项目文件）。
🛠️ 解决方法：
- 右键点击 CMD / PowerShell / Windows Terminal 图标
- 选择 “以管理员身份运行”
- 再切到 D 盘：
D: cd D:\astro-notion-blog-main - 再运行 Gemini 命令，比如：
gemini chat --context . --goal "请优化 Astro 博客的首页结构和加载速度"gemini chat --context "D:\astro-notion-blog-main" --goal "帮我解释这个项目结构"
💡 小技巧：你可以创建一个自动打开的快捷方式
新建一个 open_gemini.cmd 文件，内容如下：
@echo off
cd /d D:\astro-notion-blog-main
start cmd /k
右键 → “以管理员身份运行”，就能自动打开并定位到项目目录了。
如果你愿意，我可以直接帮你生成一个 Gemini 项目交互脚本，支持以下功能：
- 自动切换到项目目录
- 自动创建备份文件夹
- 自动调用 Gemini CLI 分析/改代码
- 自动输出结果到
gemini_suggestions/里