notepad--:零基础完成 macOS 源码编译安装(含故障速查)
2026/9/16 19:15:35 网站建设 项目流程

notepad--:零基础完成 macOS 源码编译安装(含故障速查)

【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--

用 TextEdit 打开一份 GBK 编码的文本,满屏乱码的那一刻,你就该安装并编译一下 notepad-- 了。这款轻量编辑器自带上百种语言语法高亮、编码转换和文件对比,源码内置 QScintilla 核心库,一次构建全部搞定。

接下来你依次做这些事:

  • 自检系统、装齐依赖
  • 一键拉取项目源码
  • CMake 编译核心库与主程序
  • 启动验证中文显示
  • 调好字体与默认编码
  • 卡住时对照速查表

⚙️ 环境自检与依赖安装

系统版本架构最低推荐
macOS 10.14+Intel / Apple Silicon4GB 内存 + 10GB 磁盘8GB 内存 + SSD

依赖安装三步,每步一句话:

  1. Xcode 命令行工具——C++ 编译离不开它提供的编译器、链接器和 make:
xcode-select --install
  1. Qt 5——notepad-- 的界面框架,也是它唯一稳定的 Qt 大版本:
brew install qt@5
  1. CMake 加 ninja——构建系统加并行编译,决定你的编译速度:
brew install cmake ninja

⚠️ brew 默认的qt是 Qt 6,本项目不支持,请一律显式写qt@5

Homebrew 未装过的话,按官网提示先装好再回来,这里不赘述。语法高亮引擎 QScintilla 在 src/qscint/ 下随源码提供,不用单独下载。

🛠️ 一键拉取源码并编译

  1. 拉取源码——克隆仓库并进入项目根目录,完成后你会看到一个包含src/CMakeLists.txt的目录:
git clone https://gitcode.com/GitHub_Trending/no/notepad-- && cd notepad--

💡 若你本地已有源码,跳过这一步,直接在源码目录执行下面的命令。

  1. CMake 配置并编译——配置生成构建计划,随后按依赖顺序编译 QScintilla 库、插件示例和主程序;完成后会在build/下生成可执行文件NotePad--
cmake -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)" cmake --build build -j$(sysctl -n hw.ncpu)

💡 若你在 Linux 机器(Debian/Ubuntu)上,把前面 brew 命令换成:sudo apt install qtbase5-dev qt5-default cmake,并删掉 cmake 行里的-DCMAKE_PREFIX_PATH参数。

  1. 启动验证——不装也能直接跑,首次启动会弹"免费永久使用版"对话框,点"好的"进主界面:
./build/NotePad--

首屏设置与调优

进主界面后,先做三件事:

  1. 看右下角状态栏:默认编码应是 UTF-8。打开 GBK 文件乱码时,切换为GB18030(GBK简体中文)重新加载。
  2. 在"设置"菜单里把编辑器字体和字号调成顺眼的。默认 14 号偏大,多数人选 12 号更舒服。
  3. 要改缩进宽度就编辑配置文件~/.config/notepad/nddsets/nddsettings.ini,只有两行需要关心,首次运行后该文件自动创建:
tablens=4 # 缩进宽度(空格数),想要更宽改成 8 tabnouse=0 # 0 = 保留 tab,1 = 用空格替代 tab # 其余保持默认

配置项的读写逻辑见 src/nddsetting.cpp。

notepad-- 支持文字处理类插件,两类常见用法:

名称干什么怎么装
hello world(示例)文字处理演示,把选中文本转大写编译 src/plugin/helloworld/ 工程,生成的库文件放进应用 plugin 目录
自定义文字插件简繁转换、全半角转换、JSON 格式化等按 插件编程开发说明.docx 开发,接口头文件在 src/include/pluginGl.h

左侧目录列表是内置能力:拖一个目录进去,就能浏览成树状结构。

notepad-- macOS 编辑器主界面,多标签编辑与语法高亮

📌 故障速查表

卡住了?直接看速查表:

症状大概率原因一条命令/操作解决
cmake 报找不到 Qt5qt@5 没装或路径没传给 CMakebrew install qt@5,cmake 补上-DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)"重跑
编译过程报莫名错误中文注释遇到编码识别问题把源码另存为 UTF-8-BOM 再编译,参见 编译说明.docx
打开 GBK 文件满屏乱码文件编码与显示编码不匹配右下角状态栏切到GB18030(GBK简体中文)重新加载
输入法偶发不弹出旧版本 buggit pull后重新编译
关闭编辑器后设置窗残留旧版本 bug升级到最新源码并重新编译

保持更新的命令存成习惯:git pull && cmake --build build -j$(sysctl -n hw.ncpu)。下次再遇到 GBK 文件,直接丢给 notepad-- 打开就行。

【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询