下载安装与首次启动设置

装之前：确认你的系统

这一步花不了一分钟，但能省掉后面所有的麻烦。Eagle 目前的主力版本是 Eagle 4.0.0 Build23，对系统的要求是：

• Windows：需要 Windows 10 或更高版本
• macOS：需要 macOS 10.15（Catalina）或更高版本

如果你的系统更老，可能会遇到安装包装不上、或者装上了打不开的情况。另外 macOS 用户要注意区分芯片版本——Apple Silicon（M 系列）和 Intel 的安装包是不同的，官网下载页通常会让你选，别随便点。

下载与安装

Eagle 的官方站点是 eagle.cool，首页顶部就是下载入口。你也可以从插件开发者文档站（developer.eagle.cool）的导航里找到下载链接。

安装过程和绝大多数桌面软件一样，双击安装包一路下一步即可。Windows 上如果安装到了默认位置，程序文件的路径大致类似 C:\Program Files\Eagle\Eagle.exe；macOS 上则通常在应用程序文件夹里。

如果 Windows 弹出“Windows 已保护你的电脑”的蓝色窗口，这是 SmartScreen 的正常拦截，不是病毒提示。点”更多信息“，确认发布者是 Eagle 官方，再点“仍要运行”即可。

别装在 U 盘或移动硬盘上。 Eagle 在运行时会读写大量缩略图和索引文件，放在移动介质上不仅慢，还容易因为拔插意外造成资源库损坏。装在系统盘，数据目录放到一块可靠的内部硬盘上，这是最稳的组合。

首次启动：先做这几件事

第一次打开 Eagle，界面会引导你创建一个资源库。这一步先别急着随便点，把下面这几件事做完，后面会省很多力气。

第一件事：把界面语言调成中文

Eagle 支持简体中文界面。如果启动时是英文，去 偏好设置（一般在菜单栏的 Eagle → Preferences，或 Windows 上的编辑 → 首选项附近，具体入口各版本略有差异）里找到语言设置。Eagle 官方支持的语言包括英文、简体中文、繁体中文、日文、韩文、西班牙文、德文、俄文。

第二件事：顺手挑个顺眼的主题

同一个偏好设置面板里通常也有主题选项。Eagle 提供的主题包括浅色、浅灰、灰、深色、蓝、紫几种。长期盯着素材挑图，我个人强烈建议深色主题——浅色界面上大量深色图片会显得刺眼，反之亦然，深色底面对配色和构图的干扰更小。当然这只是个人偏好，你按自己的眼睛来。

第三件事：了解资源库放在哪

这是最重要的一步。资源库（Library）是 Eagle 的工作单位，本质上就是硬盘上的一个普通文件夹，只是带了个特殊后缀。

想知道当前资源库的路径，最直接的办法是打开 偏好设置，在相关区块里查看资源库位置，或者在资源库管理相关的界面里查看。macOS 上的资源库一般是 .eagle 后缀的目录，Windows 上常见是 .library 后缀——官方文档里的示例路径就是类似 C:\Users\User\Pictures\Design.library 这样的形式。

挑选存放位置的四条原则：

1. 容量要够。 素材库会随着时间快速膨胀，尤其是你导入了大量高分辨率图片和视频之后。建议至少留出几百 GB 的空间。
2. 别放系统盘。 C 盘装系统，重装系统就没了；如果放的是 OneDrive 这类会自动同步的目录，那就不是“本地优先”了。
3. 别放桌面。 桌面容易被各种文件污染，也容易被误删。
4. 命名清楚。 一个资源库就是一个文件夹，名字起成 设计素材库、Eagle-工作 这种一眼能认出来的，将来插拔硬盘、备份、重装系统都方便找。

如果你想换个位置，通常的做法是先在目标位置建好文件夹，然后在 Eagle 的资源库管理相关功能里执行移动或重新指定路径的操作。移动大资源库时一定要等它跑完再关机，中途断电是资源库损坏的头号原因。

第四件事：想清楚要不要建多个资源库

Eagle 支持建多个资源库，它们彼此独立。这个特性什么时候用得上？比如你接公司项目用工作库，自己研究摄影用私人库，或者你想把“临时素材”和”精选收藏“分开。

对新手来说，第一个月建议只建一个库。同时开好几个库，你会分不清东西在哪，而且 AI 搜索这类能力的作用范围通常也是单个库。先把一个库用顺了再说。

资源库目录不要用手动的方式去动里面的文件。Eagle 内部通过 metadata.json 记录每个文件的标签、备注、评分等元数据（官方文档明确建议不要直接修改它），你手动删了文件或者改了元数据，索引就可能对不上。

装好之后：顺手装浏览器扩展

Eagle 的收集能力有很大一部分来自浏览器扩展。扩展的作用是让你在浏览网页时，右键就能把整页图片、某个链接、网页截图直接送进 Eagle。

官方提供了浏览器扩展的下载入口，就在 eagle.cool 的下载区域附近，具体路径大致是官网的“下载浏览器扩展”入口。支持的浏览器覆盖了主流的 Chrome、Edge、Firefox 等内核浏览器。

建议在装完软件的当天就把扩展装上，因为扩展有一个明显的作用窗口期：装得越早，你越早开始积累“随手收集”的习惯。第二章会详细讲怎么用。

如果安装扩展时浏览器提示“此扩展来自未知的发布者”，选择继续安装即可——这是自研扩展的常态。装完之后，浏览器工具栏会出现 Eagle 的图标。

装完之后的验收清单

在进入正式使用之前，花两分钟做下面这几件事确认一切正常：

1. 新建一个测试资源库，随便拖十张图进去。
2. 点开其中一张，确认右侧预览能正常显示图片。
3. 拖一张 GIF 进去，确认能正常播放——Eagle 内置了 GIF Player。
4. 拖一个字体文件进去，确认能用内置的 Font Viewer 预览字形。
5. 给其中一张图贴个标签，然后取消，再贴一次，确认标签操作正常。
6. 关掉软件再打开，确认刚才的资源库和素材都还在。

这六步都通过了，说明安装和索引机制都是健康的。如果第 2 步就出问题（缩略图空白），先去偏好设置里找找有没有“重建索引”之类的选项，具体名称各版本可能不同。

首次启动的设置项清单

为了方便你对照检查，这里把首次启动时值得确认的设置项整理成一张表。具体名称在不同版本里可能略有出入，但大方向是一致的。

注意最后两行。「AI 模型」这一项是 Eagle 4.0 Build20 之后才有的设置入口，位置就在偏好设置左侧栏。如果你使用的是更早的版本，找不到这一栏是正常的。第五章会详细讲这个统一的大模型配置中心是怎么回事。

装不上、打不开怎么办

装机环节最常遇到的问题就那么几个，逐个对号入座：

Windows 打不开安装包 / 提示系统版本过低。 右键安装包，看属性里的“兼容性”或者确认系统版本号。老版本 Windows 10 家庭版的部分构建号可能不被支持，这类情况只能升级系统，没有绕开的办法。

macOS 提示“无法打开，因为无法验证开发者”。 系统安全设置比较严。去「系统设置 → 隐私与安全性」，往下滚动，在“安全性”区块里应该能看到一句关于未验证开发者的提示，点”仍要打开“，然后再回来双击安装包。

装上了，一打开就闪退。 多半是显卡驱动或者系统环境的问题。先试试重启电脑；再试试从命令行启动看看有没有报错信息；最后可以换一个版本试试，比如换 Intel 版或 ARM 版（macOS 上尤其常见）。

界面卡顿、缩略图出不来。 大量高分辨率图片在首次导入时需要生成缩略图，这个过程会占 CPU 和磁盘带宽，属于正常现象。但如果完全看不到缩略图，在偏好设置里找找有没有“重建缩略图”或”重新生成预览图“之类的选项，名称各版本可能不同。

资源库打开了却显示为空。 多半是路径变了。比如你把资源库从一块硬盘移到了另一块，或者硬盘盘符变了。检查一下资源库目录是否还在原来的位置，然后重新指定。

一个容易被忽略的小细节：不要把资源库放在云同步目录里

这一点值得单独强调，因为它是最容易被“善意”毁掉的用法。

Dropbox、OneDrive、iCloud 这些同步工具很诱人——资源库放在里面，天然就有备份和跨机同步。但问题在于，Eagle 会在运行过程中不断写入缩略图和索引文件，这些频繁的小文件写入：

1. 会让同步软件陷入无尽的文件监听和上传循环；
2. 在多台机器上同时运行时，可能出现索引冲突，导致素材记录不一致；
3. 同步中断导致的半成品文件有可能让资源库读取出错。

所以更稳妥的做法是：资源库放在纯本地磁盘上，备份交给专门的备份方案——可以是定期整目录复制到移动硬盘，也可以用支持增量备份的工具。Eagle 的好处正在于资源库就是一个普通文件夹，你随时可以直接复制它来做备份，不需要导出、不需要解压。

本地优先的意思是“我控制我的数据”，不是”我的数据只有一份“。养成定期备份的习惯，是用本地工具的必修课。

关于版本更新

Eagle 的更新比较频繁，官方会通过应用内的更新提示来推送。建议保持自动更新，这样你在用新功能（比如智能文件夹、AI Action 这类较新的能力）时才不会因为版本太低而看不到入口。

但有一个例外要记住：新功能经常有版本门槛。比如 AI 模型配置中心（AI SDK 相关能力）需要 Eagle 4.0 Build20 或更高版本；智能文件夹和标注相关的部分能力需要 Build22 或更高。所以偶尔遇到“文档里写了但我的软件里没有”，第一反应应该是查版本。

常见坑

坑一：把资源库装在系统盘或者移动硬盘上。 系统盘重装会丢，移动硬盘拔插可能损坏索引。放在一块可靠的内部数据盘上，是最稳的。

坑二：把资源库放在 OneDrive、iCloud 这类自动同步的目录里。 频繁的索引写入会让同步陷入循环，还可能造成多机索引冲突。同步交给专门的备份方案，别用文件级同步。

坑四：手动往资源库目录里塞文件。 Eagle 通过内部的元数据文件追踪每个素材，一切入库都通过软件界面完成，手动放文件会导致索引对不上。

小结

这一节其实只做了三件小事：把软件装上、把界面调顺手、把资源库放在一个靠谱的位置。但这三件事的质量决定了后面所有操作的体验——资源库位置选得不好，你会在某次备份或换机时付出巨大的代价。

接下来，我们要在资源库里建一套属于自己的文件夹结构。这是整个 Eagle 使用流程的地基，值得多想一分钟。

整理人：WorkBuddy