notepad--:零基础完成 macOS 源码编译安装(含故障速查)
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
用 TextEdit 打开一份 GBK 编码的文本,满屏乱码的那一刻,你就该安装并编译一下 notepad-- 了。这款轻量编辑器自带上百种语言语法高亮、编码转换和文件对比,源码内置 QScintilla 核心库,一次构建全部搞定。
接下来你依次做这些事:
- 自检系统、装齐依赖
- 一键拉取项目源码
- CMake 编译核心库与主程序
- 启动验证中文显示
- 调好字体与默认编码
- 卡住时对照速查表
⚙️ 环境自检与依赖安装
| 系统版本 | 架构 | 最低 | 推荐 |
|---|---|---|---|
| macOS 10.14+ | Intel / Apple Silicon | 4GB 内存 + 10GB 磁盘 | 8GB 内存 + SSD |
依赖安装三步,每步一句话:
- Xcode 命令行工具——C++ 编译离不开它提供的编译器、链接器和 make:
xcode-select --install- Qt 5——notepad-- 的界面框架,也是它唯一稳定的 Qt 大版本:
brew install qt@5- CMake 加 ninja——构建系统加并行编译,决定你的编译速度:
brew install cmake ninja⚠️ brew 默认的
qt是 Qt 6,本项目不支持,请一律显式写qt@5。
Homebrew 未装过的话,按官网提示先装好再回来,这里不赘述。语法高亮引擎 QScintilla 在 src/qscint/ 下随源码提供,不用单独下载。
🛠️ 一键拉取源码并编译
- 拉取源码——克隆仓库并进入项目根目录,完成后你会看到一个包含
src/和CMakeLists.txt的目录:
git clone https://gitcode.com/GitHub_Trending/no/notepad-- && cd notepad--💡 若你本地已有源码,跳过这一步,直接在源码目录执行下面的命令。
- 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参数。
- 启动验证——不装也能直接跑,首次启动会弹"免费永久使用版"对话框,点"好的"进主界面:
./build/NotePad--首屏设置与调优
进主界面后,先做三件事:
- 看右下角状态栏:默认编码应是 UTF-8。打开 GBK 文件乱码时,切换为
GB18030(GBK简体中文)重新加载。 - 在"设置"菜单里把编辑器字体和字号调成顺眼的。默认 14 号偏大,多数人选 12 号更舒服。
- 要改缩进宽度就编辑配置文件
~/.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 报找不到 Qt5 | qt@5 没装或路径没传给 CMake | brew install qt@5,cmake 补上-DCMAKE_PREFIX_PATH="$(brew --prefix qt@5)"重跑 |
| 编译过程报莫名错误 | 中文注释遇到编码识别问题 | 把源码另存为 UTF-8-BOM 再编译,参见 编译说明.docx |
| 打开 GBK 文件满屏乱码 | 文件编码与显示编码不匹配 | 右下角状态栏切到GB18030(GBK简体中文)重新加载 |
| 输入法偶发不弹出 | 旧版本 bug | git 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),仅供参考