企业官网建设流程全解析

ani-cli Windows 安装避坑指南：Git Bash + Windows Terminal 终极配置方案

【免费下载链接】ani-cliA cli tool to browse and play anime项目地址: https://gitcode.com/gh_mirrors/an/ani-cli

ani-cli 是一款在终端中搜索并在线播放动漫的开源命令行工具，ani-cli Windows 安装的官方推荐方案是：用 scoop 装好 ani-cli，再在 Windows Terminal 中新建一个 Git Bash 配置文件（profile）来运行它。只要按本指南走完 4 个步骤、绕开 3 个高频坑，Windows 用户也能获得和 Linux 上一样的顺滑体验：搜番、选集、播放一气呵成。

📺 动手前 30 秒：ani-cli 是怎么工作的

ani-cli 的交互被设计成一台状态机：输入关键词 → 从搜索结果挑一部动漫 → 选择一集 → 解析播放链接 → 交给 mpv 播放器开播，如下图所示：

更底层的抓取流程（搜索 → 提取播放链接 → 按清晰度选流播放）在项目的 hacking.md 文档中有完整说明：

理解了这套流程，你就明白为什么它对终端环境比较"挑剔"——这也是 Windows 安装要避坑的原因。

🧰 第 1 步：安装前准备——装齐"三件套"

ani-cli Windows 安装只依赖三样东西：scoop 包管理器、Windows Terminal、Git。

1. scoop：前往 scoop 官网，按 Quickstart 说明一次性粘贴安装命令即可。
2. Windows Terminal：Windows 11 已自带；如果没有，在 PowerShell 中运行：

scoop bucket add extras scoop install extras/windows-terminal

3. Git：已有建议更新，没有则运行scoop install git。

💡 为什么必须要 Git？因为 ani-cli 真正运行的环境是 Git for Windows 自带的 bash，Windows Terminal 只是更稳定的"外壳"。

🖥️ 第 2 步：在 Windows Terminal 中配置 Git Bash 配置文件

这是整个ani-cli Windows 安装最关键、也最多人出错的一步。

先打开 Windows Terminal，点击新标签页按钮（+）旁边的下拉箭头，确认列表中是否已有Git Bash。如果没有，依次点击Settings > Profiles > Add a new profile，再点New empty profile：

然后按下表填写参数（scoop 安装的 Git 填左列，其它方式安装的填右列）：

填完点右下角Save。再到Settings > Startup把 Default profile 设为 Git Bash，以后打开终端就直接进入正确环境（可选但推荐）。

📦 第 3 步：用 scoop 安装 ani-cli 本体与依赖

在 Windows Terminal 的Git Bash配置文件里依次执行：

scoop bucket add extras scoop install ani-cli scoop install fzf ffmpeg mpv

• fzf：交互式搜索界面，必装
• mpv：视频播放器，必装
• ffmpeg：下载功能的回退方案
• 想离线看番，建议再装一个下载器：scoop install yt-dlp

▶️ 第 4 步：首次运行与日常更新

ani-cli # 直接搜索一部番开看 ani-cli -h # 查看全部参数说明 ani-cli -U # 更新到最新版（遇到问题时先执行它）

常用参数速查：-d下载当前集、-q 1080指定清晰度、--dub看英语配音、--vlc改用 VLC 播放。完整参数见ani-cli --help、项目自带手册 ani-cli.1，核心逻辑在主脚本 ani-cli 中。

🛠️ 避坑清单：三大常见报错的最快修复

① 卡死在Search anime:搜索框

原因：用的是 Git 自带的 mintty 小终端（老式 Git Bash 黑窗口），fzf 与它不兼容。 修复：回到第 2 步，改用 Windows Terminal + Git Bash 配置文件运行；实在想用 mintty，可先执行export MSYS=enable_pcon再运行 ani-cli。

② PowerShell / CMD 里报No such file or directory或 WSL 相关错误

原因：%USERPROFILE%\scoop\shims\ani-cli.cmd里的@bash调到了 WSL 的 bash，而不是 Git for Windows 的 bash。 修复（推荐）：直接在 Windows Terminal 的 Git Bash 配置文件里运行 ani-cli。如必须用 PowerShell/CMD，用记事本打开上述ani-cli.cmd，把@bash替换为@"C:\Program Files\Git\bin\bash.exe"（scoop 装的 Git 则替换为@"%GIT_INSTALL_ROOT%\bin\bash.exe"）。

③ 搜索失败或播放异常

• 先执行ani-cli -U更新到最新版——官方在 README.md 中把它列为首选排障手段
• curl 版本过旧会导致请求失败，可用scoop install curl升级（7.86.0 及以上已验证可用）
• scoop 安装的 mpv 读取的是便携配置C:\Users\用户名\scoop\apps\mpv\current\portable_config，修改播放器配置时别改错地方

✅ 安装完成自检

• Windows Terminal 下拉列表里能看到 Git Bash
• ani-cli -h正常输出帮助
• 搜索关键词能出结果、不卡死
• 选集后 mpv 自动打开播放

全部打勾，恭喜——你的 ani-cli Windows 环境已经稳了。🎉 日后想卸载，运行scoop uninstall ani-cli即可。

【免费下载链接】ani-cliA cli tool to browse and play anime项目地址: https://gitcode.com/gh_mirrors/an/ani-cli