把约 340 万条 ECDICT 英汉词条带入 macOS 原生查词体验。
界面示意动画，非系统录屏。 演示 v1.2.1 的“首屏看释义 → 点击更多看详情”。具体高度、字号与展开方式由 macOS 和查询应用决定。查看最新查询页面。
这是一款为 Apple 自带“词典”应用制作的大规模离线英汉词典。安装后无需打开浏览器，即可在 Dictionary.app、右键“查询”和触控板三指轻点中查看音标、词性与中文释义。数据保存在本机，不需联网、账号或常驻进程。
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 数据制作，将上游 MDX 转换为 Apple Dictionary.app 可直接读取的 .dictionary 格式。它适合在阅读、写作、编程和学习时追求快速、安静且无广告查词体验的用户。
| 项目 | 说明 |
|---|---|
| 词典数据 | 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 和部分系统级文本服务。
- 收录单词、变形、短语、专有名词和大量扩展词目；
- 词头、音标和 Oxford/Collins 评级同行排版，减少三指查询中的纵向占用；
- Oxford/Collins 保留轻量评级徽章，考试大纲与 BNC/COCA 词频以次要文本展示；
- 词性使用固定宽度，多行释义严格对齐；
- 动词的过去式、过去分词、现在分词和第三人称单数使用带名称的词形标签排版；
- 采用适配 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 可能优先显示系统级副本；请只保留一个正式版本。
- 打开“词典”→“设置…”，取消勾选本词典。
- 退出“词典”。
- 在访达中前往
~/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 原作者均无隶属、合作或背书关系。词典内容按原许可证“按原样”提供，不保证所有释义均准确或适合专业用途。