我终于用上了 gmini-cli：这体验太酷了！

大家好，我是你们的朋友，一个热爱折腾各种新鲜技术的程序员。最近，AI 命令行工具的风潮是越来越热，前有 Warp，后有 Cursor，但我最近发现了一个新宝贝——gmini-cli。它能让你在终端里，通过对话的方式，直接生成代码、操作文件，甚至构建一个完整的项目。

经过一番折腾，我终于成功地用它跑通了我的第一个实战项目：生成一个带地图的厦门三天两夜旅游攻略网页。从环境配置的抓狂，到最后看到那个漂亮页面的成就感，这趟旅程可以说非常刺激。

今天，我就把这完整的体验分享出来，带大家从头到尾走一遍。无论你是经验丰富的开发者，还是对 AI 感兴趣的小白，相信这篇文章都能让你有所收获。

第一部分：安装 gmini-cli，以及那些“坑”

想用神器，必先利其器。gmini-cli 的安装过程不算复杂，但如果你不注意细节，也可能会遇到一些问题。

如何安装 gmini-cli？

gmini-cli 是一个基于 Node.js 的工具，所以请确保你的电脑里已经安装了 Node.js (建议版本 >= 18.0.0)。

打开你的终端 (无论是 Windows 的 PowerShell/CMD，还是 macOS 的 Terminal)。
执行安装命令。通过 npm（Node.js 的包管理器）来全局安装：
npm install -g @google/gmini-cli
配置 Gemini API 密钥。gmini-cli 需要连接到 Google 的 Gemini Pro 模型。你需要获取一个 API 密钥。
- 访问 Google AI for Developers。
- 点击 “Get API key in Google AI Studio”。
- 登录你的 Google 账号，然后创建一个新的 API 密钥。
- 拿到密钥后，在终端里执行以下命令，把你的密钥配置到环境变量中：
gmini init
然后将你的 API 密钥粘贴进去并回车。
验证安装。输入以下命令，如果能看到版本号，就说明安装成功了！
gmini --version

安装中常见的问题和解决办法

我在安装过程中也踩了一些坑，这里总结一下，希望能帮你绕过去：

问题一：npm install 报错，提示权限问题 (Permission Denied)
- 原因：这通常发生在 macOS 或 Linux 系统上，因为全局安装需要管理员权限。
- 解决办法：在命令前加上 sudo，授予管理员权限。
  sudo npm install -g @google/gmini-cli
问题二：安装后执行 gmini 命令，提示“command not found” (找不到命令)
- 原因：这是最常见的问题，说明 npm 的全局安装路径没有被添加到系统的环境变量 PATH 中。
- 解决办法：
  1. 首先，找到 npm 的全局安装路径。执行 npm root -g 查看路径。
  2. 然后，将这个路径添加到你的系统环境变量 PATH 中。具体方法可以搜索“如何为 xx 系统添加环境变量”。
  3. 添加后，重启你的终端，这一步很重要！
问题三：杀毒软件或防火墙拦截
- 原因：某些比较严格的杀毒软件可能会误判 gmini-cli 的网络请求或文件操作。
- 解决办法：在安装和使用时，暂时关闭杀毒软件，或者将其添加到信任列表中。

第二部分：实战开始！在 VSCode 中生成厦门旅游攻略

环境搞定了，让我们来玩点真格的。我的目标是：在 VSCode 里，使用 gmini-cli 生成一个漂亮的厦门旅游攻略网页。

这个攻略需要包含：

三天两夜的详细行程。
使用 高德地图 MCP Server 来展示地图（听起来很高级，别怕，我们一步步来）。
页面要用 HTML + Tailwind CSS + JavaScript 构建，并且要尽可能美观。

第一步：在高德开放平台申请 API Key

要使用高德地图的服务，我们首先需要一个它的 API Key。

前往高德开放平台，注册并登录你的账号。
进入“应用管理” -> “我的应用”，然后点击“创建新应用”。
为你的应用起个名字，类型选择“Web端”。
创建成功后，点击“添加”，为你的应用添加一个 Key。在“Key名称”处随便填一个，然后在“服务平台”处选择“Web端 (JSAPI)”。
保存后，你就能在列表中看到你刚刚创建的 Key 和安全密钥 (Key & Secret)，把它们复制下来备用。

第二步：理解 MCP Server 是什么

MCP (Map Content Platform) Server 是高德地图提供的一种服务，它允许开发者通过服务端接口获取地图数据和内容，然后以自定义的方式在前端展示。简单来说，我们不需要在前端加载笨重的地图库，而是直接请求一个包含了内容的地图图片或服务，更轻量、更灵活。

在 gmini-cli 的语境下，提及使用 MCP Server，就是告诉它，我们希望它生成的代码是调用高德地图的服务端 API 来获取地图信息，而不是简单地嵌入一个 iframe。

第三步：在 VSCode 中向 gmini-cli 下达指令

我在 VSCode 中打开了一个名为 GAODE 的空文件夹，然后打开终端，输入了下面这段神奇的指令 (prompt)：

"在 GAODE 目录中，帮我用 HTML + Tailwind css + js 和高德地图 MCP Server 生成一份厦门三天两夜的游玩攻略，尽可能详细。要求：1. 推荐几家性价比高的酒店。2. 查询并告知主要景点的门票是否免费。3. 如果初次生成的页面不够美观，请继续帮我美化它。"

按下回车，见证奇迹的时刻到了！gmini-cli 开始思考，然后...

它开始创建文件、写入代码，终端里飞速地滚动着日志。不到一分钟，我的 GAODE 目录里就出现了一个 index.html 文件。

第三部分：成果展示与持续优化

初版页面与内容

gmini-cli 生成的第一个版本已经相当惊艳了。它不仅创建了 HTML 结构，引入了 Tailwind CSS 的 CDN，还真的帮我规划好了行程。

行程规划如下：

主题：厦门三日两夜·浪漫文艺之旅
酒店推荐：
- 厦门毕思特酒店（中山路步行街店）：性价比高，位置绝佳，方便逛街和品尝美食。
- 厦门鼓浪屿屿见精品民宿：想体验鼓浪屿的宁静夜晚，这家评价不错。
- 曾厝垵艾嘉客栈：适合喜欢热闹和文艺小店的年轻人。
行程安排：
- Day 1: 环岛路骑行 - 曾厝垵 - 中山路步行街
  - 上午：从酒店出发，租一辆自行车，沿着环岛路骑行，享受海风。（免费）
  - 中午：在曾厝垵解决午餐，这里汇集了各种厦门小吃。
  - 下午：逛曾厝垵的文艺小店。（免费）
  - 晚上：前往中山路步行街，品尝地道美食，如花生汤、沙茶面、海蛎煎。
- Day 2: 鼓浪屿一日游
  - 上午：从轮渡码头坐船前往鼓浪屿（船票需提前预定，约 ¥35）。上岛后，游览日光岩（门票约 ¥50）、菽庄花园（门票约 ¥30）。
  - 中午：在岛上龙头路附近品尝小吃。
  - 下午：漫步于万国建筑博览群，找个安静的咖啡馆度过悠闲时光。
  - 傍晚：返回市区。
- Day 3: 南普陀寺 - 厦门大学 - 返程
  - 上午：参观千年古刹南普陀寺。（免费）
  - 中午：在南普陀寺品尝著名的素斋。
  - 下午：前往旁边的厦门大学（需提前在官方渠道预约），感受中国最美大学的魅力。（免费，但需预约）
  - 之后：根据你的时间安排返程。