Linux 版 Notepad-- 多语言支持实现指南
一 架构总览
- 语言识别：通过ExtLexerManager维护“文件扩展名 → 语言类型（LangType）”的映射，内置超过**60+**种语言类型（如 L_CPP、L_PYTHON、L_MARKDOWN），并支持用户扩展（以 L_EXTERNAL=100 起始）。打开文件时按扩展名自动绑定对应词法分析器。
- 词法与高亮：基于 Scintilla/QsciLexer 派生类实现各语言的词法规则（关键字、注释、数字、字符串等），运行时通过工厂按 LangType 创建具体 QsciLexer 实例。
- 主题与样式：采用“主题-语言-元素”三级样式体系，主题目录（如 Monokai）下为不同语言提供独立配置（例如 cpp.ini、python.ini），并支持全局样式 AllGlobal.ini；切换主题或语言时会重绘样式。
- 自动补全：基于 Scintilla 的自动补全框架，结合词法上下文提供建议；当前版本默认关闭，可在设置中启用并配置触发阈值与来源。
二 开箱即用的语言支持
- 预置语言与扩展名：默认内置对 C/C++、Python、Java、JavaScript、HTML/CSS、Markdown、Go、Rust、PHP、Ruby、Bash/Shell、JSON、YAML、Makefile、CMake 等主流语言的高亮支持，覆盖常见开发场景。
- 多语言识别流程：启动时加载扩展-语言映射表（如 .cpp→L_CPP、.py→L_PYTHON、.md→L_MARKDOWN），打开文件按扩展名自动选择对应 QsciLexer 并应用主题样式。
- 动态切换语言：支持在编辑器中运行时切换语言（重建/切换 QsciLexer 实例），即时刷新高亮与样式。
三 添加或自定义语言
- 自定义扩展映射：通过 ExtLexerManager::addNewExtType(ext, lexerId, langTagName) 将新扩展名绑定到已有语言类型（如把 .myext 绑定到 L_CPP），或绑定到用户自定义类型（≥ L_EXTERNAL）。
- 用户自定义词法器：为自定义语言创建 QsciLexer 派生类，设置关键字、注释、字符串、数字等规则，并在工厂中注册；运行时由 LangType 创建实例。
- 自定义主题样式：在主题目录下新增或编辑语言专属 .ini（如 myext.ini），定义元素样式（颜色、字体、粗体/斜体等）；需要时同步调整 AllGlobal.ini 的全局元素以保持一致性。
- 自动补全扩展：在配置中为自定义语言补充关键字与 API 词库（如编辑 tag_ext 配置段），并在运行时设置补全阈值与来源，以获得更精准的建议。
四 界面与系统层面的多语言
- 界面中文化：在 Notepad– 菜单 Set → Languages → Chinese 可切换界面为中文；该菜单项用于切换 UI 语言包。
- 系统语言环境：确保 Linux 系统已安装并启用 zh_CN.UTF-8 等 locale（如 Debian/Ubuntu 执行 sudo dpkg-reconfigure locales 勾选 zh_CN.UTF-8 与 en_US.UTF-8），并在 ~/.profile 或 ~/.bashrc 中设置环境变量（如 LANG=zh_CN.UTF-8、LC_ALL=zh_CN.UTF-8），以避免界面或终端出现乱码。
- 字体与显示：若仍有中文方块或乱码，安装常用中文字体（如 文泉驿微米黑、Noto Sans CJK）并在编辑器或系统字体设置中启用。
五 常见问题与排查
- 新扩展未高亮：检查是否已通过 ExtLexerManager 正确注册“扩展名 → 语言类型”，或手动在设置中指定语言；必要时为自定义语言补充主题 .ini。
- 自动补全不生效：当前版本默认关闭，需在设置中启用，并将触发阈值设为 1–2 个字符；确认补全来源（文档/API）与语言词库配置正确。
- 中文显示异常：优先确认系统 locale 为 zh_CN.UTF-8，并安装中文字体；若从终端启动，确保终端环境也使用 UTF-8。
