1. 为什么是 GoldenDict-ng不是 GoldenDict也不是其他词典软件GoldenDict-ng 这个名字一出现很多人第一反应是“哦GoldenDict 的新版本”——其实这个理解既对又不对。它确实脱胎于经典开源词典工具 GoldenDict但绝不是简单换个图标、加几个按钮的“v2.0”。它是用Qt6 从零重写的现代实现底层架构、UI 渲染、插件机制、多线程模型全部重构目标非常明确解决原版 GoldenDict 在高分辨率屏幕、多显示器、深色模式、HiDPI 缩放、中文输入法兼容性、大词库加载卡顿等场景下长期存在的“老毛病”。我最早在 2018 年就用 GoldenDict 查《朗文当代高级英语辞典》LDOCE5当时得手动改 DPI 设置、关掉动画、禁用某些词库才能勉强流畅而去年我把主力词典切换到 GoldenDict-ng 后同一台笔记本4K 屏 Windows 11 23H2开 3 个词库欧路、MDX、StarDict、同时查英文日文德文词条滚动、跳转、模糊搜索响应几乎无延迟。这不是“优化”是换了一套呼吸系统。核心关键词里反复出现的Qt6就是这场重构的基石。Qt6 不再是 Qt5 的小修小补它彻底抛弃了 OpenGL 依赖转向 Vulkan / Metal / Direct3D 12 的统一渲染后端对现代显卡驱动更友好其信号槽机制重写后内存泄漏风险大幅降低QML 2.0 的引入让界面主题真正可热重载不用重启就能切深色/浅色/高对比度模式。这直接决定了 GoldenDict-ng 能否在 macOS Ventura、Windows 11、Ubuntu 22.04 LTS 这些新系统上“原生跑起来”而不是靠 Wine 或兼容层硬扛。而“开源”二字不只是许可证写着 GPL-3.0 就完事——它的 GitHub 仓库github.com/goldendict-ng/goldendict-ng里每个 commit 都带详细说明issue 区活跃着全球用户提的中文分词 bug、日文活用形匹配失败、俄语词干提取不准等问题维护者会逐条回复、复现、提交 patch。我去年提过一个关于 PDF 词典导出时页眉错位的问题三天后就收到 PR 链接附带测试用例和截图。这种透明度是商业词典软件永远做不到的。至于“免费开源词典工具”这个定位它精准卡在两个痛点之间一边是收费软件如欧路词典专业版、DeepL Pro功能强但年费不低且数据封闭、无法自定义词库源另一边是纯网页词典如 Cambridge Online、Oxford Learner’s Dictionaries依赖网络、离线不可用、无法批量查词、不能做笔记导出。GoldenDict-ng 把“本地优先”做到极致所有词库文件.mdx、.dsl、.dict.dz全存在你硬盘上查词不发包、不传词、不联网——你查“quantum entanglement”还是“量子纠缠”后台都不会有服务器记录你的查询历史。这对语言学习者、翻译工作者、学术研究者尤其关键。我带研究生做古籍英译时常需查大量冷僻术语用 GoldenDict-ng 搭配《汉英大词典》第三版 MDX 和《牛津古典学词典》PDF 扫描版OCR 后转为 StarDict 格式整个过程完全离线查词速度比网页版快 3 倍以上还能把高频词一键导出为 CSV 做统计分析。这不是“能用”而是“能深度工作”。2. 安装配置全流程拆解为什么必须分三步走少一步都可能白忙活很多人搜“GoldenDict-ng 安装配置”点开教程就直接复制粘贴命令结果卡在“找不到 qt6base.dll”或“启动黑屏”。问题不在教程错而在没理解安装本质GoldenDict-ng 不是一个“双击安装包就完事”的传统软件它是一套运行时环境 核心程序 词库资源的组合体。漏掉任何一环就像只买了发动机没配变速箱车根本动不了。我实测过 17 种常见安装路径最终确认最稳、最易复现、最适配新手的只有三步法环境准备 → 程序部署 → 词库挂载。下面逐层拆解每步背后的逻辑。2.1 环境准备Qt6 运行时不是可选而是强制依赖GoldenDict-ng 编译时链接的是 Qt6 的动态库.dll/.so/.dylib这意味着它启动时必须在系统 PATH 或程序同目录下找到这些库文件。Windows 用户最容易踩坑下载官网预编译包goldendict-ng-1.9.0-win64.zip解压后双击 goldendict-ng.exe弹窗报错“VCRUNTIME140_1.dll 丢失”或“Qt6Core.dll 未找到”。这不是程序坏了是你系统缺了两样东西Microsoft Visual C 2015-2022 运行库和Qt6 运行时组件。VCRUNTIME140_1.dll 是微软 C 运行时几乎所有现代 Qt6 应用都依赖它。解决方案很简单去微软官网下载 “vc_redist.x64.exe”注意必须是 x64 版即使你用 Win10 32 位也别装错静默安装vc_redist.x64.exe /install /quiet /norestart。我试过不装这个直接跑100% 失败。Qt6 运行时组件则更隐蔽。官方 zip 包里其实自带了 Qt6 库在bin/子目录下但 Windows 默认不认子目录里的 dll。正确做法是把goldendict-ng-1.9.0-win64\bin\下所有Qt6*.dll文件Qt6Core.dll、Qt6Gui.dll、Qt6Widgets.dll 等共 12 个全部复制到主程序目录即goldendict-ng.exe所在文件夹。别嫌麻烦这是最省心的方案。有人想用set PATH%PATH%;.\bin临时加路径但一旦你用快捷方式启动环境变量就失效了。macOS 用户要注意签名问题。Apple 对未公证的应用限制严格下载 dmg 后双击提示“已损坏”是常态。别急着删打开“访达”→右键GoldenDict-ng.app→“显示简介”→勾选“仍要打开”。后续每次启动都会弹窗点“好”即可。真正的坑在 Qt6 的 Metal 渲染后端——如果你用的是 M1/M2 Mac确保系统是 macOS 12.3 及以上否则 Qt6 会 fallback 到 OpenGL导致滚动卡顿。我实测 M1 Pro macOS 12.6.7 完全流畅但 12.2.1 就必须手动改启动参数加-platform cocoa才能稳定。Linux 用户最省心但也最易忽略权限。Ubuntu/Debian 系统直接sudo apt install libqt6gui6 libqt6widgets6 libqt6core6即可装齐 Qt6 运行时。但注意GoldenDict-ng 官方不提供 deb/rpm 包你下的是 tar.xz解压后chmod x goldendict-ng是必须的。CentOS 7 用户会发现libstdc.so.6: version GLIBCXX_3.4.26 not found这是因为 CentOS 7 自带的 GCC 版本太老4.8.5而 Qt6 编译要求 GCC 9。解决方案不是升级系统风险大而是用官方提供的 AppImage 包——它自带所有依赖双击即用比源码编译省 3 小时。提示验证 Qt6 环境是否到位最简单方法是打开终端Windows 用 PowerShellcd 到程序目录执行./goldendict-ng --versionLinux/macOS或goldendict-ng.exe --versionWindows。如果输出类似GoldenDict-ng 1.9.0 (Qt 6.5.3)说明环境 OK如果报“command not found”或“missing library”就回头检查 dll/so 文件位置或运行时安装。2.2 程序部署配置文件位置决定一切别乱放GoldenDict-ng 启动时会按固定顺序查找配置文件goldendict-ng.conf路径优先级是1命令行指定--config /path/to/conf2当前工作目录下的goldendict-ng.conf3用户配置目录Windows%APPDATA%\GoldenDict-ng\macOS~/Library/Application Support/GoldenDict-ng/Linux~/.local/share/goldendict-ng/。绝大多数人失败是因为把 conf 文件放错了地方。比如你在桌面解压 zip双击运行程序就会去%APPDATA%\GoldenDict-ng\创建默认配置。但你想改字体大小、启用划词翻译就得编辑这个 conf 文件。问题是Windows 资源管理器默认隐藏AppData文件夹你根本找不到它。正确路径是按WinR输入%APPDATA%回车进入后找GoldenDict-ng文件夹。里面会有goldendict-ng.conf和dictionaries/词库目录。千万别手动创建dictionaries文件夹并往里扔词库——程序不会自动扫描必须在 conf 里显式声明路径。conf 文件是纯文本 INI 格式关键 section 是[Dictionaries]。这里不是写“C:\dics\oxford.mdx”而是写相对路径或绝对路径。我推荐用绝对路径避免因启动位置不同导致加载失败。例如[Dictionaries] path0C:/Users/YourName/Documents/GoldenDict/dicts/oxford.mdx path1C:/Users/YourName/Documents/GoldenDict/dicts/longman5.dsl path2C:/Users/YourName/Documents/GoldenDict/dicts/jmdict.dsl注意Windows 路径用正斜杠/或双反斜杠\\单反斜杠\会被当转义符处理导致路径错误。macOS/Linux 用/Users/xxx/...即可。另一个易错点是iconv编码转换。很多老词库尤其是 StarDict 格式用 GBK 或 Big5 编码而 GoldenDict-ng 默认用 UTF-8 读取。查中文时显示乱码在 conf 的[General]section 加一行encodingGBK或Big5。我试过 23 个不同来源的中文词库80% 需要设 encoding否则“苹果”显示成“蘋果”或“蘋菓”。注意修改 conf 后必须完全退出程序再重启热重载不生效。很多人改完字体设置发现没变就是因为只点了“应用”没关进程。任务栏右键 → “退出”或用任务管理器杀掉goldendict-ng.exe进程。2.3 词库挂载格式支持≠能用元数据才是关键GoldenDict-ng 支持 MDX、DSL、StarDict、ABBYY、Sdictionary、ZIM 等 12 种格式但“支持”不等于“开箱即用”。比如 MDX 词库表面看是.mdx.mdd一对文件但实际需要.mdx内嵌的 CSS 样式、JavaScript 交互脚本、图片资源路径都正确指向。我下载过某网站打包的《新世纪汉英大词典》MDX解压后发现所有图片路径是http://dict.example.com/img/xxx.png离线根本加载不了。解决方案是用mdx2html工具把 MDX 转成 HTML 文件夹再用 GoldenDict-ng 的“本地网页词库”功能加载——但这牺牲了搜索速度。真正高效的词库挂载必须满足三个条件格式合规、元数据完整、资源内联。以 DSL 格式为例它本质是纯文本但需要.dsl文件头部有正确声明#NAME 朗文当代高级英语辞典 #INDEX_CHARSET utf-8 #CONTAINING_DICTS #FORMAT html #OPTIONS NOCASE其中#INDEX_CHARSET必须与文件实际编码一致UTF-8 最稳妥#FORMAT html告诉程序用 HTML 渲染器解析。我见过有人把 GBK 编码的 DSL 文件强行标utf-8结果查词全乱码。验证方法用 VS Code 打开.dsl文件右下角看编码显示再对照头部声明。StarDict 词库更麻烦。它由.idx索引、.dict.dz压缩词典、.ifo信息文件三部分组成。.ifo文件里必须有wordcount123456和idxfilesize789012这两个数字必须与实际文件大小严格匹配否则程序启动时会报“词典损坏”。我修复过一个wordcount写错的词库用 Python 脚本重算真实词数再用十六进制编辑器如 HxD改.ifo文件对应位置。过程耗时 40 分钟但换来的是 100% 准确的跳转。ZIM 格式是未来方向它把整个维基百科、Wiktionary 打包成单文件支持全文检索、图片内嵌、超链接。但 ZIM 文件极大英文维基约 70GB且 GoldenDict-ng 目前只支持 ZIM v2不支持最新的 v3。下载时务必认准https://download.kiwix.org/zim/官方镜像别用第三方压缩包——有些包把 ZIM 解压成文件夹那已经不是 ZIM 了。3. 核心功能深度配置从划词翻译到 PDF 批注这才是生产力核心装好只是起点GoldenDict-ng 的价值全在配置细节里。很多人以为“能查词就行”结果浪费了 80% 的功能。我把它分成三类刚需场景即时查词划词/快捷键、深度阅读PDF/EPUB 集成、知识管理笔记/导出。每个场景都有非调不可的参数。3.1 划词翻译不是打开开关就完事得调灵敏度和触发逻辑GoldenDict-ng 的划词功能CtrlAltT 默认原理是截获鼠标选中文字 → 发送到词典引擎 → 返回结果。但 Windows 系统级划词有两大干扰源UAC 权限弹窗和输入法状态。比如你用搜狗拼音选中英文时输入法处于中文模式划词会失败。解决方案是在 conf 的[HotKeys]section 加[HotKeys] selectTextKeyCtrlAltT selectTextDelay300 selectTextIgnoreInputMethodtrueselectTextDelay300表示鼠标松开后 300ms 再触发避开输入法切换的抖动selectTextIgnoreInputMethodtrue强制忽略输入法状态确保中英文混排也能划。macOS 上更复杂。系统隐私设置里“辅助功能”必须勾选 GoldenDict-ng否则无法监听鼠标事件。而且 macOS 的“连按左键”手势三指轻点查词与 GoldenDict-ng 冲突必须关掉系统设置 → 触控板 → 指针与点击 → 三指轻点设为“无操作”。划词结果展示位置也有讲究。默认是悬浮窗口但遮挡 PDF 阅读很烦。我在[Appearance]section 设[Appearance] popupPositionfixed popupX100 popupY100 popupWidth400 popupHeight300这样每次划词都固定出现在屏幕左上角 100,100 坐标宽度 400px高度 300px不随鼠标移动阅读 PDF 时眼睛不用追着窗口跑。实操心得划词翻译最怕“误触发”。我写论文时经常选中一整段引用文字结果弹出 20 个词的释义窗口。解决办法是启用selectTextMinLength3最小选中长度 3 字符这样单个字母或“a/the”不会触发。这个参数在 conf 里没有默认值必须手动添加。3.2 PDF/EPUB 集成让词典真正长在阅读器里GoldenDict-ng 本身不是阅读器但它能通过 D-BusLinux/macOS或 COMWindows协议与外部阅读器深度联动。主流 PDF 阅读器中OkularLinux/KDE、SkimmacOS、Sumatra PDFWindows支持最好。以 Sumatra PDF 为例配置步骤在 Sumatra PDF 设置里Settings → Advanced Options找到ExternalViewerssection加一行ExternalViewers [ [ Command C:\Program Files\GoldenDict-ng\goldendict-ng.exe Arguments --word %s Name GoldenDict-ng ] ]在 GoldenDict-ng 的 conf 里[General]section 加[General] enableExternalViewerIntegrationtrue externalViewerPort8080这样你在 Sumatra PDF 里选中单词 → 右键 → “Search in GoldenDict-ng”程序就会自动跳转到该词释义页并高亮显示。更绝的是GoldenDict-ng 还能反向控制查完词后点“在 PDF 中定位”它会调用 Sumatra PDF 的 DDE 接口把 PDF 页面跳转到该词首次出现的位置。我测试过 127 页的 LaTeX 论文 PDF定位误差不超过 ±2 行。EPUB 支持靠的是内置的 EPUB 渲染引擎基于 Qt WebEngine。把.epub文件拖进 GoldenDict-ng 主窗口它会自动解压并建立索引。但有个隐藏技巧EPUB 里的a hrefglossary.xhtml#term1term1/a这种内部链接GoldenDict-ng 默认不处理。必须在 conf 里加[EPUB] enableInternalLinkstrue glossaryFilePatternglossary.*\.xhtml这样点击术语链接就能跳转到词典附录页。我用这个功能把《The Elements of Style》EPUB 版的写作术语表直接变成可交互词典。3.3 笔记与导出把碎片知识变成结构化资产GoldenDict-ng 的“笔记”功能常被忽略但它其实是知识管理的核心。查到一个生词点右下角“添加到笔记”它会存入notes.dbSQLite 数据库。但默认只存单词和释义没上下文。我在[Notes]section 手动扩展[Notes] includeContexttrue contextLinesBefore2 contextLinesAfter2 includeSourceDictionarytrue exportFormatmarkdown这样导出笔记时每条记录包含单词、音标、释义、例句、原文上下文前后各 2 行、来源词库名。导出为 Markdown 后用 Obsidian 打开自动变成双向链接笔记。比如查“serendipity”笔记里会带一句“She found the rare book by serendipity while browsing a dusty attic.”这句话就成了这个词的永久记忆锚点。导出功能不止于笔记。文件 → 导出当前词条可生成 HTML/PDF但默认样式丑。黄金配置是自定义 CSS在~/.local/share/goldendict-ng/styles/Linux建custom.css内容body { font-family: Segoe UI, PingFang SC, sans-serif; line-height: 1.6; } h1 { color: #2c3e50; border-bottom: 2px solid #3498db; } .term { font-size: 1.4em; font-weight: bold; color: #e74c3c; }然后在 conf 的[Export]section 指定[Export] styleSheetcustom.css pdfPageSizeA4 pdfMarginTop20 pdfMarginBottom20导出的 PDF 就像专业出版物字号、行距、页边距全可控。我每月把查过的 200 专业术语导出为 PDF打印出来钉成本子比电子笔记记得牢。4. 常见问题与排查技巧实录那些官方文档不会写的坑再完美的工具落地时也会遇到各种“薛定谔的故障”。以下是我在 3 年实际使用中整理出的 7 类高频问题及独家排查法。每个问题都附真实日志片段和解决步骤不是网上抄来的泛泛而谈。4.1 启动黑屏/闪退十有八九是显卡驱动或 DPI 缩放惹的祸现象双击goldendict-ng.exe窗口一闪消失任务管理器里进程存在 0.5 秒后自动退出。Windows 事件查看器里 Application 日志报错“Application Error: faulting module name: Qt6Gui.dll”。排查步骤先排除病毒用 Windows Defender 全盘扫描goldendict-ng.exe确认无威胁。检查显卡驱动NVIDIA 用户去 GeForce Experience → “驱动程序” → “检查更新”必须升到 535.98 以上旧版驱动对 Qt6 Vulkan 后端兼容差AMD 用户用 Adrenalin 23.5.1Intel 核显用户确保 Windows Update 已装最新“Intel Graphics Driver”。关闭 DPI 缩放右键goldendict-ng.exe→ “属性” → “兼容性” → “更改高 DPI 设置” → 勾选“替代高 DPI 缩放行为”缩放执行选择“应用程序”。这是最关键一步我 80% 的黑屏案例都因此解决。终极方案启动时加参数强制用 OpenGL 渲染仅临时诊断goldendict-ng.exe -platform windows:OpenGL。如果能启动说明是 Vulkan 兼容问题需更新驱动。注意不要迷信“重装 Qt6 运行时”。Qt6 库已打包在 bin/ 目录重装系统级 Qt6 反而可能冲突。专注驱动和 DPI 设置。4.2 中文词库不显示/乱码编码声明与文件实际编码必须咬死现象加载《现代汉语词典》MDX查“苹果”显示“蘋果”或“????”但英文词库正常。排查步骤用file命令Linux/macOS或chcpWindows确认系统默认编码。Windows 命令提示符输入chcp显示“活动代码页936”即 GBK。用 VS Code 打开.mdx文件需装 MDX 插件右下角看编码。如果显示“GBK”但 conf 里encodingutf-8立刻改成encodingGBK。更隐蔽的情况MDX 文件本身是 UTF-8但内嵌的 CSS 里用了 GBK 字体名如font-family: SimSun。这时需用mdx2html工具导出 HTML用文本编辑器全局替换SimSun为Microsoft YaHei再重新打包 MDX。验证在 GoldenDict-ng 里查一个确定有汉字的词右键 → “查看源码”看 HTML 里汉字是否正常显示。如果源码里就是乱码说明 MDX 文件损坏需重下。4.3 划词无反应检查输入法、UAC、后台进程三重门现象CtrlAltT 没反应鼠标选中文字后无悬浮窗。排查步骤输入法切换到英文输入法Win空格再试划词。如果成功说明是输入法冲突。搜狗/百度输入法设置里关掉“智能中英文切换”和“划词翻译”功能。UAC 权限右键goldendict-ng.exe→ “以管理员身份运行”再试划词。如果成功说明是权限问题。解决方案在 conf 里加selectTextUseSystemHooktrue启用系统级钩子无需管理员权限。后台进程残留任务管理器里看是否有goldendict-ng.exe进程在运行即使窗口关闭了。结束所有相关进程再启动。测试钩子Windows PowerShell 运行Get-Process | Where-Object {$_.ProcessName -eq goldendict-ng}如果返回空说明进程没起来如果返回进程但划词无效大概率是输入法或 UAC。4.4 PDF 定位失败不是词典问题是 PDF 文本层缺失现象在 Sumatra PDF 里查“algorithm”GoldenDict-ng 返回结果但点“在 PDF 中定位”没反应。排查步骤先确认 PDF 有文本层用 Adobe Acrobat 打开 PDF →CtrlShiftT如果弹出“此文档不包含文本”提示说明是扫描版 PDF必须 OCR。即使有文本层也可能被加密。Adobe Acrobat →文件 → 属性 → 安全看“文档限制”是否允许“内容复制”。如果禁止需用 PDF 密码移除工具如 qpdf解密。GoldenDict-ng 的 PDF 定位依赖词典引擎的“词干匹配”。查“algorithms”PDF 里原文是“algorithm”定位会失败。解决方案在 conf 的[PDF]section 加pdfStemmingtrue启用词干提取。终极验证用pdftotext your.pdf - | grep -i algorithm如果返回空说明 PDF 文本层有问题不是 GoldenDict-ng 的锅。4.5 词库加载慢别怪程序先看磁盘和词库结构现象启动 GoldenDict-ng 要 20 秒点“词典”菜单卡住。排查步骤检查磁盘Windows 用defrag /C /H碎片整理机械硬盘必做SSD 用户用 CrystalDiskInfo 看健康度低于 90% 可能影响随机读取。词库位置把词库从 NAS 或 USB 移动硬盘移到 SSD 本地盘。我测试过10GB 的 Wiktionary ZIM 文件NAS 加载需 15 秒NVMe SSD 只需 1.2 秒。词库数量GoldenDict-ng 启动时会扫描所有词库索引。如果挂了 50 个词库即使每个只 1MB扫描时间也指数增长。解决方案在 conf 的[Dictionaries]section只保留常用词库的path其他用#path注释掉需要时再取消注释。索引重建右键词库 → “重建索引”对 StarDict/MDX 有效。但 ZIM 无法重建只能重下。4.6 更新后功能异常配置文件迁移不是自动的现象从 1.8.0 升级到 1.9.0划词失效笔记丢失。原因Qt6 重构后conf 文件结构有变化。1.8.0 的goldendict-ng.conf里[HotKeys]section 名是[Shortcuts]1.9.0 已废弃。升级后程序会生成新 conf但旧 conf 不会自动合并。解决方案备份旧 conf重命名为goldendict-ng.conf.bak。启动 1.9.0让它生成新 conf。用 Beyond Compare 对比两个 conf把旧 conf 里[Dictionaries]、[Notes]、[Appearance]等 section 的内容手工复制到新 conf 对应位置。特别注意1.9.0 新增了[ExternalViewers]section旧版没有必须按新格式写。4.7 macOS 上无法拖拽 PDF沙盒限制与权限的博弈现象把 PDF 文件拖到 GoldenDict-ng 窗口没反应Dock 图标闪烁一下。原因macOS 的 App Sandbox 限制了文件访问权限。GoldenDict-ng 默认只能访问“文档”文件夹PDF 如果在“下载”或“桌面”拖拽会被拒。解决方案打开系统设置 → 隐私与安全性 → 完全磁盘访问勾选 GoldenDict-ng。如果还不行用终端命令授予权限tccutil reset All com.goldendict.ng然后重启程序。终极方案不要拖拽用文件 → 打开在弹窗里点左下角“前往文件夹”输入/Users/YourName/Downloads/就能看到所有文件。5. 进阶玩法用脚本和插件把 GoldenDict-ng 变成你的专属知识中枢装好、配好、用顺之后真正的生产力爆发点在于自动化集成。GoldenDict-ng 提供了丰富的扩展接口命令行参数、D-Bus/COM API、插件系统Qt Plugin、配置文件热重载。下面分享三个我每天都在用的实战案例代码可直接抄作业。5.1 一键查词脚本VS Code 里选中单词秒开 GoldenDict-ng需求写代码时看到陌生 API如 Python 的asyncio.run()不想切窗口直接查。实现Windows PowerShell 脚本gdict.ps1# 获取 VS Code 当前选中文本 $selection Get-Clipboard if ($selection -match ^\w$) { # 构造 GoldenDict-ng 启动命令 $cmd C:\Program Files\GoldenDict-ng\goldendict-ng.exe --word $selection Invoke-Expression $cmd } else { Write-Host 选中内容非单词跳过 }在 VS Code 里CtrlShiftP→ “Preferences: Open Keyboard Shortcuts (JSON)”加[ { key: ctrlaltd, command: workbench.action.terminal.runSelectedText, args: { text: pwsh -ExecutionPolicy Bypass -File \C:\\Scripts\\gdict.ps1\ } } ]现在 VS Code 里选中run按CtrlAltDGoldenDict-ng 瞬间弹出asyncio.run释义。Linux/macOS 用户把pwsh换成bash路径用$HOME/Scripts/gdict.sh即可。5.2 自动同步笔记查词后 5 秒笔记自动推送到 Obsidian需求查完词不想手动导出希望实时同步到知识库。实现Python 脚本sync_notes.py需装obsidian-api包import sqlite3 import time from datetime import datetime from obsidian_api import Vault # 连接 GoldenDict-ng 笔记数据库 conn sqlite3.connect(rC:\Users\YourName\AppData\Roaming\GoldenDict-ng\notes.db) cursor conn.cursor() # Obsidian vault 路径 vault Vault(rC:\Users\YourName\Documents\Obsidian\MyVault) while True: # 查询最新一条未同步笔记 cursor.execute(SELECT word, definition, context FROM notes WHERE synced 0 ORDER BY id DESC LIMIT 1) row cursor.fetchone() if row: word, defn, ctx row # 生成 Markdown 文件 content f# {word} {defn} ## Context {ctx} --- Created: {datetime.now().strftime(%Y-%m-%d %H:%M)} # 写入 Obsidian vault.create_file(fdictionaries/{word}.md, content) # 标记为已同步 cursor.execute(UPDATE notes SET synced 1 WHERE word ?, (word,)) conn.commit() time.sleep(5) # 每 5 秒检查一次把这个脚本设为开机自启Windows 用任务计划程序macOS 用 launchd查词后笔记自动出现在 Obsidian 的dictionaries/文件夹里支持全文搜索和图谱分析。5.3 自定义词库生成器把网页词典一键转成 GoldenDict-ng 可用格式需求某个小众语言词典只有网页版如 https://example.com/dict/想离线用。实现Python BeautifulSoupimport requests from bs4 import BeautifulSoup import csv def scrape_dict(url): headers {User-Agent: Mozilla/5.0} soup BeautifulSoup(requests.get(url, headersheaders).content, html.parser) words [] for item in soup.select(.entry): # 根据网页实际 CSS 选择器调整 word item.select_one(.headword).get_text().strip() pos item.select_one(.pos).get_text().strip() defn item.select_one(.definition).get_text().strip() words.append([word, pos, defn]) return words # 生成 CSV再用 csv2dsl 工具转 DSL words scrape_dict(https://example.com/dict/) with open(custom_dict.csv, w, newline, encodingutf-8) as f: