☰
如何 5 分钟装好 GoAnime:跨平台安装与首次动漫搜索保姆级教程
2026/10/15 10:48:12 网站建设 项目流程

【免费下载链接】GoAnime

Search, stream and download anime, movies and TV shows from the terminal, in English and Brazilian Portuguese.

项目地址:https://gitcode.com/gh_mirrors/go/GoAnime
点击查看免费下载

GoAnime 是一个用 Go 编写的终端动漫流媒体与下载工具,支持按名字搜索动漫、电影和电视剧,直接在 mpv 中播放或批量下载剧集。本教程带你 5 分钟完成 GoAnime 跨平台安装(Windows / macOS / Linux 全支持),并完成第一次动漫搜索,全程只需几条命令。

🎬 GoAnime 能做什么?

装好之前先花 30 秒了解它能帮你做什么:

  • 多源同步搜索:默认同时搜索 AllAnime、AnimeFire、FlixHQ 等多个平台,结果更全
  • 搜索 + 流媒体播放:搜到动漫、电影、TV 剧集后,选集、选画质,自动拉起 mpv 播放
  • 离线下载:单集、区间(如第 1-5 集)或整季批量下载,文件按 Plex 命名规范保存
  • 中英/葡字幕与配音:同时支持英语和巴西葡语的 subbed / dubbed 内容
  • 进度追踪:记住播放位置,下次断点续播、自动标记已看剧集
  • Discord RPC:向好友展示你正在看什么

完整功能清单可参考 README.md。

⚙️ 准备工作:1 分钟装好两个依赖

GoAnime 只有两个前置依赖:

依赖作用安装方式
Go 1.26+编译 GoAnime(推荐最新版)从 Go 官网下载对应平台的安装包
mpv实际播放视频的媒体播放器(推荐最新版)见下方各系统命令

各系统安装 mpv 的常用命令:

# Debian / Ubuntu sudo apt update && sudo apt install mpv # macOS (Homebrew) brew install mpv # Arch / Manjaro sudo pacman -S mpv

Windows 用户请安装 mpv 并确保其位于系统 PATH 中(安装时勾选 "Add to PATH" 即可)。

⚡ 最快安装:3 条命令编译出 GoAnime

下面这个「克隆 + 编译」方案对 Windows、macOS、Linux 通用,也是最稳的方式:

git clone https://gitcode.com/gh_mirrors/go/GoAnime cd GoAnime go build -o goanime ./cmd/goanime

Windows 用户把最后一条命令换成:

go build -o goanime.exe .\cmd\goanime

编译完成后,把可执行文件放进 PATH 目录,终端里任意位置都能直接调用:

# Linux / macOS sudo mv goanime /usr/local/bin/ # Windows:把 goanime.exe 移到任意已加入 PATH 的目录,例如 C:\Users\你\bin

💡 编译入口源码位于 cmd/goanime/main.go,所有命令参数在 internal/util/help.go 中定义,方便你日后自行扩展。

📦 各平台替代安装方式(可选)

如果你不想编译,也可以按平台选择更省事的方式:

  • Arch / Manjaro:一条命令搞定,yay -S goanime(构建脚本见 aur/goanime/PKGBUILD)
  • Windows:从官方 releases 页下载 GoAnimeInstaller.exe 安装包,双击运行即可
  • macOS / Linux 预编译二进制:从官方 releases 页下载对应平台的压缩包,解压后将二进制放入 PATH 目录,Linux 记得chmod +x添加执行权限

✅ 验证安装成功

goanime --version

看到类似下面的输出就说明装好了:

GoAnime v1.8.4 (without SQLite tracking)

括号里的内容代表是否带 SQLite 播放进度追踪:显示with SQLite tracking表示支持断点续播和已看记录;显示without SQLite tracking则仅关闭该功能,搜索、播放、下载等全部功能不受影响。

🎯 首次搜索:4 步开始看片

第 1 步:启动交互模式

打开终端,输入goanime回车,进入搜索界面:

goanime

第 2 步:输入动漫名

按提示输入你想看的动漫名字(支持模糊匹配,输入一半也能联想出结果)。

第 3 步:从列表中挑选

用方向键在搜索结果列表中选择目标作品,按Enter确认。

第 4 步:选集、选画质、开始播放

选择具体集数和视频画质后,视频会自动在 mpv 中打开,坐等开演即可。🍿

懒人捷径——直接搜索:把动漫名作为参数传入,跳过初始提示,一步直达结果列表:

goanime "Naruto"

注意多个单词直接用空格分隔,比如goanime "one piece"。

看电影和电视剧:加--type参数切换媒体类型:

goanime --type movie "Avengers" goanime --type tv "Breaking Bad"

📥 下载常用参数速查表

看爽了想离线收藏?以下参数覆盖 90% 的下载场景:

参数作用示例
-d下载指定集数goanime -d "one piece" 1
-r区间批量下载goanime -d -r "naruto" 1-5
-a下载全部剧集goanime -d -a "one piece"
--source指定数据源(allanime / animefire)goanime -d --source allanime "bleach" 10
--quality指定画质(best / 720p / 1080p)goanime -d --quality 720p "demon slayer" 1
-o自定义下载目录goanime -d -o ~/Anime "naruto" 1
--type movie电影/剧集下载goanime -dm -a "breaking bad"

默认下载目录为~/.local/goanime/downloads/anime/,文件按 Plex 规范命名(如Anime - S01E01.mp4),方便媒体库直接识别。

🔄 装完之后:一键自我更新

GoAnime 内置了自动更新,无需手动重新下载安装:

goanime --update

它会自动检查新版本、下载、备份旧版本并安全替换,失败还能自动回滚。更新机制的细节可以看看 docs/AUTO_UPDATE.md。

❓ 新手常见问题(FAQ)

Q1:终端提示找不到 goanime 命令?检查可执行文件是否已放入 PATH 目录(如/usr/local/bin),然后重开一个终端窗口再试。

Q2:运行时提示CGO_ENABLED=0/ SQLite 相关错误?说明你用的是不带 SQLite 的标准构建,进度追踪功能被禁用,其他功能全部正常。如需断点续播,参考 docs/BUILD_OPTIONS.md 安装 SQLite 开发库后重新编译即可。

Q3:mpv 没有自动弹出播放窗口?确认 mpv 已安装且mpv --version能正常输出;Windows 用户请检查 mpv 是否已加入 PATH。

Q4:播放时看不到字幕?GoAnime 主要支持英语和巴西葡语的字幕/配音内容;电影类资源可通过--subs english等参数指定字幕语言,或用--no-subs关闭字幕。

🎉 总结

到这里,你已经完成了 GoAnime 的完整跨平台安装流程:准备 Go + mpv → 3 条命令编译 → 验证版本 → 首次搜索看片。日常只需要记住两条命令:goanime交互搜索、goanime --update保持最新。想看更多高级用法(Anime4K 超分、智能跳片头、Discord 展示等),输入goanime -h即可查看完整帮助。

【免费下载链接】GoAnime

Search, stream and download anime, movies and TV shows from the terminal, in English and Brazilian Portuguese.

项目地址:https://gitcode.com/gh_mirrors/go/GoAnime
点击查看免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询