简体中文 | English
在 Mac 上随手查词：约 340 万条 ECDICT 英汉词条，离线可用，融入系统查询。
为阅读英文资料、写作、编程和英语学习提供随手可用的中文释义。安装到 Apple 自带的“词典”后，即可在 Dictionary.app 或支持系统“查询”的应用中查词，无需为每次查询打开浏览器。
An offline English–Chinese dictionary for macOS, with around 3.4 million ECDICT entries in Dictionary.app and system Look Up. Read the English guide →
界面示意动画，非系统录屏。 演示 v1.2.1 的“首屏看释义 → 点击更多看详情”。具体高度、字号与展开方式由 macOS 和查询应用决定。查看最新查询页面。
安装完成后，查词无需联网、注册账号或运行额外的常驻程序。右键“查询”和触控板三指轻点的可用性取决于应用、设备与系统设置。
Note
项目正在建设面向英语学习者的语义重构层：它会在不改写 ECDICT 原始数据的前提下，为经过审核的高价值词条提供按英文语义重新组织的释义、简短英文解释和至多一条例句。当前 Release 仍以稳定的原始数据渲染为主；详见语义重构架构。
Important
首次启用时，除了勾选“ECDICT 简明英汉字典”，还需在“词典”设置中至少勾选一个 macOS 系统自带词典。在部分 macOS 版本上，只启用第三方词典可能无法正常显示查询结果。
打开“终端”，粘贴下面一整行并按回车：
curl -fsSL https://github.com/343534-code/ecdict-macos-dictionary/releases/latest/download/install.sh | /bin/bash脚本会从 GitHub Releases 下载最新版、核对 SHA-256、备份同名旧版，并安装到当前用户的 ~/Library/Dictionaries/，不需要管理员密码。脚本内容可在运行前先打开 scripts/install.sh 审查。
- 从 Releases 下载 ZIP 并解压。
- 把整个
ECDICT 简明英汉字典.dictionary复制到~/Library/Dictionaries/。 - 打开 Mac“词典”→“设置…”（
Command-,），勾选 ECDICT，并同时勾选至少一个系统自带词典。
首次安装、旧版清理和故障排查请参阅下方的macOS 安装流程。
ECDICT macOS Dictionary 将 skywind3000/ECDICT 1.0.28 的英汉数据转换为 Apple Dictionary.app 可读取的 .dictionary 格式，并针对完整词典页面与快速查询浮窗优化排版。
快速查询先展示各词性的第一条原始释义，便于阅读时迅速把握词义；展开“更多”可继续查看剩余释义及源数据中已有的词形、考试标签与词频信息。约 340 万条记录涵盖单词、变形、短语和专有名词，并不等同于 340 万个独立常用单词；不同词条包含的字段也有所不同。
| 项目 | 说明 |
|---|---|
| 词典数据 | ECDICT 1.0.28，约 340 万条词条 |
| 查询方式 | Dictionary.app、三指轻点、右键“查询”及部分系统文本服务 |
| 词条内容 | 词头、音标、词性、中文释义，以及源数据中已有的可点击词形变化、考试标签与 BNC/COCA 词频 |
| 运行方式 | 完全离线，无账号、无广告、无常驻进程 |
| 其他格式 | 同时提供 MDX，可导入欧路词典、GoldenDict 和 MDict 等软件 |
v1.2.1： 快速查询首屏优先展示各词性的第一条原始释义；点击系统“更多”后，继续查看剩余释义、专业标签、词形变化、考试大纲与词频。完整 Dictionary.app 页面仍按词性组织释义。这是排版与展开改进，不代表全库已进行 AI 语义重构。
以下为历史 v1.2.0 截图对照，最新布局见查询页面。
| ECDICT | macOS 系统自带词典 |
|---|---|
 |
 |
两张截图均来自同一台 Mac 上的实际 Dictionary.app 查询，没有使用模拟或生成界面。ECDICT v1.2.0 在紧凑布局中直接展示评级、词形变化、考试大纲与词频排名。
安装后可通过以下入口查词：
- macOS 自带“词典”应用；
- 在支持的应用中选中单词后使用“查询”；
- 触控板三指轻点查询；
- 右键菜单中的“查询”；
- Spotlight 和部分系统级文本服务。
- 融入阅读流程：在 Dictionary.app 中浏览完整词条，或在支持的应用里通过右键、三指轻点调用系统查询。
- 先看释义，再看细节：快速查询首屏保持精简，展开后查看其余内容；完整页面按词性组织释义。
- 学习信息集中呈现：保留源数据中的音标、Oxford/Collins 标记、具名词形变化、考试标签和 BNC/COCA 词频，减少来回查找。
- 离线使用，无额外负担：数据保存在本机，无账号、无广告，不收集使用数据，也不需要额外的常驻进程。
- 兼顾不同阅读场景：提供深色外观样式及 MDX 下载；系统查询浮窗的最终样式由 macOS 决定。
- 来源与构建可审查：公开转换脚本、样式和构建配置，保留上游数据来源与许可证说明。
Oxford 3000表示该词属于牛津 3000 核心词汇；Collins 1★–5★表示柯林斯词频星级，星数越高通常越常用；中考、高考、CET4等标签表示 ECDICT 原数据收录的考试大纲标记；BNC #80和COCA #60是该词在英国国家语料库与美国当代英语语料库中的词频排名，数字越小表示越常见。
标签忠实反映原数据：例如
(中高 80/60)只包含“中考”、“高考”和两个词频排名，不会凭空增加 CET4。
- macOS 10.11 或更高版本（构建目标；未逐一验证所有历史版本）；
- 安装后约占 424 MiB；建议预留至少 1.5 GB 空间用于下载、解压与旧版备份；
- 一行命令和 ZIP 安装不需要管理员密码；PKG 系统级安装需要管理员密码。
请前往仓库的 Releases 页面：
| 文件 | 用途 |
|---|---|
ECDICT-macOS-Dictionary-v1.2.1.zip |
用户级 ZIP 安装包，无需管理员密码（推荐） |
ECDICT-macOS-Dictionary-v1.2.1.pkg |
系统级图形化安装包，需要管理员密码（未签名、未公证） |
ECDICT-MDX-1.0.28.mdx |
上游官方 MDX，适用于欧路词典、GoldenDict、MDict 等 |
install.sh |
一行命令使用的开源安装脚本 |
SHA256SUMS.txt |
Release 附件的 SHA-256 校验值 |
请下载同一 Release 的 SHA256SUMS.txt，在下载目录运行 shasum -a 256 -c SHA256SUMS.txt。仅下载部分附件时，未下载文件会提示找不到；核对你实际下载文件的结果即可。
- 完全退出 macOS“词典”应用，不要只关闭窗口。
- 在“词典”设置中取消勾选以前安装的 ECDICT 版本。
- 前往
~/Library/Dictionaries/，移走名称中含“优化版”、“高对比版”或“结构化版”的旧.dictionary文件夹。
首次安装可直接跳过本节。
打开“终端”，执行：
curl -fsSL https://github.com/343534-code/ecdict-macos-dictionary/releases/latest/download/install.sh | /bin/bash脚本会自动完成下载、SHA-256 校验、旧版备份和用户级安装。完成后仍需打开“词典”→“设置…”，勾选 ECDICT 和至少一个系统自带词典。
如果以前通过 PKG 安装过系统级版本，脚本会检测
/Library/Dictionaries/中的旧副本并停止，以免系统级旧版遮蔽用户级新版。此时请直接下载最新 PKG 覆盖更新。
- 下载
ECDICT-macOS-Dictionary-v1.2.1.zip。 - 双击 ZIP 文件解压，得到
ECDICT 简明英汉字典.dictionary。 - 完全退出 macOS“词典”应用（按
Command-Q）。 - 在访达菜单中选择“前往”→“前往文件夹…”。
- 输入
~/Library/并按回车。 - 打开其中的
Dictionaries文件夹；如果不存在，请新建一个名为Dictionaries的文件夹。 - 将整个
ECDICT 简明英汉字典.dictionary复制进去，不要只复制其中的Contents。 - 重新打开 macOS“词典”，然后打开“词典”→“设置…”。
- 在列表底部找到并勾选“ECDICT 简明英汉字典”。
- 必须同时勾选至少一个 macOS 系统自带词典，例如系统提供的英语词典或英汉词典。在部分 macOS 版本上，只勾选 ECDICT 可能无法显示释义。
- 可将 ECDICT 拖到列表前部，使系统查询优先显示本词典。
- 再次完全退出并重新打开“词典”，搜索
two确认可以正常显示释义。
- 从 Releases 下载
ECDICT-macOS-Dictionary-v1.2.1.pkg。 - 双击安装包，并按提示输入管理员密码。
- 安装包会把词典放入系统级
/Library/Dictionaries/，供这台 Mac 的用户使用。 - 打开“词典”→“设置…”，勾选 ECDICT，并同时勾选至少一个系统自带词典。
Warning
当前 PKG 没有使用 Apple Developer Installer 证书签名。如果 macOS 阻止打开，请确认文件来自本仓库 Release 且 SHA-256 与上方一致，然后在“系统设置”→“隐私与安全性”中选择“仍要打开”。介意未签名安装包时，请使用一行命令或 ZIP 安装。
解压后执行：
mkdir -p "$HOME/Library/Dictionaries"
ditto "ECDICT 简明英汉字典.dictionary" \
"$HOME/Library/Dictionaries/ECDICT 简明英汉字典.dictionary"
killall -9 LookupViewService com.apple.DictionaryServiceHelper 2>/dev/null || true
killall Dictionary 2>/dev/null || true随后打开“词典”→“设置…”，勾选该词典，并同时勾选至少一个系统自带词典。再次完全退出并重新打开“词典”，搜索 two 测试。
- 打开“系统设置”。
- 进入“触控板”→“光标与点按”。
- 开启“查询与数据检测器”。
- 将操作方式设置为“三指轻点”。
- 在 Safari、备忘录、TextEdit 或其他支持系统查询的应用中，把指针移到英文单词上并用三指轻点。
若查询浮窗没有显示本词典，请先确认它已在“词典”设置中勾选，并尝试将其拖到其他词典之前。
- 下载
ECDICT-MDX-1.0.28.mdx。 - 在目标软件中打开“词典管理”或“导入词典”。
- 选择下载的
.mdx文件。 - 启用词典并根据需要调整查询优先级。
不同软件的菜单名称可能不同，请参考对应软件的导入说明。
- 先确认旧版的安装位置：ZIP/一行命令通常在
~/Library/Dictionaries/，PKG 在/Library/Dictionaries/。 - 用与旧版相同的方式更新：用户级版可再次运行一行命令；系统级版请运行新 PKG。
- 完全退出并重新打开“词典”，确认 ECDICT 已勾选。
- 查询
release，点击“更多”，确认能看到第二条名词释义、词形变化、考试标签与 BNC/COCA 词频。
如果三指查询仍显示旧版页面，请先保存工作，完全退出并重新打开发起查询的应用（例如浏览器或文本编辑）。仅重启“词典”或查询服务不一定能刷新该应用持有的旧索引。必要时注销后重新登录；不要直接删除整个系统缓存目录。
如果同名旧版仍被缓存，可先将旧版取消勾选，退出“词典”，再安装新版。
如果同时存在 /Library/Dictionaries/ 和 ~/Library/Dictionaries/ 两个同名副本，Dictionary.app 可能优先显示系统级副本；请只保留一个正式版本。
- 打开“词典”→“设置…”，取消勾选本词典。
- 退出“词典”。
- 在访达中前往安装位置：ZIP/一行命令通常为
~/Library/Dictionaries/，PKG 为/Library/Dictionaries/（移除系统级副本可能需要管理员密码）。 - 将对应
.dictionary文件夹移到废纸篓。 - 重新打开“词典”。
- 确认复制的是完整
.dictionary文件夹； - 确认路径是当前用户的
~/Library/Dictionaries/； - 完全退出并重新打开“词典”；
- 在“词典”→“设置…”列表底部查找并手动勾选；
- 必要时注销并重新登录 macOS。
- 打开“词典”→“设置…”；
- 确认“ECDICT 简明英汉字典”已勾选；
- 再至少勾选一个 macOS 系统自带词典；
- 完全退出“词典”并重新打开，然后再次查询。
这是部分 macOS 版本加载第三方词典时的兼容性要求，不代表 ECDICT 需要联网。
如果仍无法显示释义，请检查 ~/Library/Dictionaries/ 中是否还存在以前的 ECDICT 测试版；移走旧版后，再次完全退出并重新打开“词典”。
系统查询只使用“词典”设置中已启用的来源。请勾选本词典，并将它拖到靠前位置。已经打开的查询浮窗不会即时刷新，需要关闭后重新触发。
macOS 的三指查询浮窗会过滤或覆盖第三方词典的部分 CSS。Dictionary.app 中能看到完整排版；快速查询浮窗中的颜色可能随系统版本和外观模式变化。
词典包含约 340 万条源记录及离线正文。v1.2.1 解压后的 .dictionary 约 424 MiB，属于正常体积。
构建需要：
- Python 3；
readmdict==0.1.1和python-lzo==1.15；- LZO 系统库（Homebrew 用户可执行
brew install lzo）； - Apple Dictionary Development Kit；
- 上游 ECDICT MDX 文件。
先安装 LZO 系统库，再安装已锁定的 Python 依赖：
brew install lzo
python3 -m pip install -r requirements.txt导出结构化 XML：
python3 scripts/export_ecdict_styled.py \
"简明英汉字典增强版.mdx" \
"dictionary-source/ECDICT-styled.xml"然后进入 dictionary-source，确认 Makefile 中的 Dictionary Development Kit 路径，再运行：
make all成品会生成在 dictionary-source/objects/。完整构建需要较长时间和数 GB 临时磁盘空间。
Apple 已不再面向普通用户维护 Dictionary Development Kit，因此不同 macOS 版本的构建兼容性可能有所差异。Apple 开发工具本身不包含在本仓库中。
dictionary-source/ 样式、XSL、偏好设置、Info.plist 和 Makefile
scripts/ MDX 到 Apple Dictionary XML 的转换脚本
semantic_cleanup/ AI 语义重构的数据契约、规则、批处理与校验层
docs/semantic-architecture.md 语义重构架构、质量门槛与性能策略
requirements.txt 已锁定的 Python 构建依赖
LICENSE ECDICT 1.0.28 的 MIT License
NOTICE 数据来源和非官方声明
词典数据和上游 MDX 来自 ECDICT 1.0.28。本仓库保留该版本中 Copyright (c) 2017 Linwei 的 MIT License 许可声明；MDX 内嵌说明另外将数据描述为“MIT / CC”双协议，但未指明具体 CC 版本。本仓库以已保留的 MIT 文本作为再分发依据，转换脚本和排版修改也按同一 MIT License 提供。
本项目是非官方转换版本，与 Apple Inc. 及 ECDICT 原作者均无隶属、合作或背书关系。词典内容按原许可证“按原样”提供，不保证所有释义均准确或适合专业用途。