Notepad-- Mac 版完整指南:装完即用的中文文本编辑器
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
你接过同事发来的 .txt,双击打开却是一屏 □□□;或者同时挂着十几个文件,切个标签就卡半拍。Notepad-- 是一款来自国内的轻量 Mac 文本编辑器,原生支持 GB18030、GBK 等中文编码,主打"打开就正常显示"。这篇指南带你三分钟装好它,再把最影响体验的几项设置和真实使用场景过一遍。
Notepad-- 适合谁:它比传统编辑器强在哪
如果你日常要处理中文旧文档、或者受够了"装个编辑器先装 500MB 依赖",先看这三点。
- 中文编码是默认能力,不是附加功能。内置 20 余种编码(GB18030、GBK、GB2312、BIG5 等)的自动识别与互转,拿到乱码文件先别急着重做,多半是编码的事。
- 轻,是真的轻。核心基于原生 Qt 5 + QScintilla 编辑内核(见 CMakeLists.txt),不是 Web 套壳,冷启动是秒级,日常挂着几个文件几乎感觉不到它。
- 插件生态为中文场景设计。源码内置插件加载框架与示例插件(src/plugin/helloworld/),可按需动态加载,不用的不占内存。
一句话:处理中文内容多、不想被 Electron 体积拖累的用户,最该试它。
三分钟跑起来
环境检查和安装其实可以一步到位:Mac 端只依赖 Xcode 命令行工具和 Homebrew,下面两条路径任选其一。
最快路径:预编译包安装
普通用户 4 步搞定,全程不用碰终端:
- 从项目发布页下载最新的 .dmg 安装包;
- 双击打开磁盘映像;
- 把 Notepad-- 图标拖入 Applications 文件夹;
- 首次打开若提示"未知开发者",按住 Control 键点击 Dock 图标选择"打开",或在 系统设置 → 隐私与安全性 里点"仍要打开"。
进阶路径:源码编译 Mac 版
开发者走这条。先装好依赖,再 clone、编译:
xcode-select --install brew install qt@5 cmake ninjagit clone https://gitcode.com/GitHub_Trending/no/notepad-- cd notepad-- && mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix qt@5) make -j$(sysctl -n hw.ncpu)关键提示:项目固定依赖Qt 5(见 CMakeLists 中find_package(Qt5 REQUIRED ...)),装了 Qt 6 的机器请用brew link --force qt@5并指对CMAKE_PREFIX_PATH,否则会在配置阶段就报错。

装好后先开一个文件看看:左侧是文件浏览器,底部状态栏会实时显示当前文件的编码与行尾格式,后面两个场景都会用到它。
装好后前五分钟:三个立刻见效的设置
这三个设置不改,中文用户大概率会踩坑;改完,后面的体验完全不一样。
| 设置 | 改了之后会有什么变化 |
|---|---|
| 中文字体 | 注释里的中文不再显示成细方块,行高和字距都正常 |
| 默认编码 UTF-8 | 新建文件按 UTF-8 落盘,发给别人不再出现"你那边是乱码" |
| 大文件上限与内存 | 几 MB 的日志、构建产物能直接打开,不再提示文件过大 |
设置文件是用户级 INI(macOS 下位于~/Library/Preferences/notepad/目录),手动编辑最小配置即可,6 行以内:
[Editor] font=PingFang SC,14 defaultEncoding=UTF-8 [Performance] maxFileSize=2048 memoryLimit=1024改完重启程序生效。字体一栏也可以换成你顺眼的等宽字体,状态栏和编辑区会同步跟随。

拿这三个场景练练手
功能列表记不住,场景能。下面三个都是日常真实会发生的事。
场景一:跨文件批量查找替换
- 痛点:重构函数名,旧名散落在几十个文件里,一个一个改到怀疑人生。
- 操作路径:菜单栏「查找」→「在目录查找」,填入目标目录、限定文件类型(如
*.cpp*.h)、要替换的关键词,点「全部替换」。 - 结果:窗口下方直接列出每个文件、每行的命中位置,可逐条确认或一键完成,改完心里有数。
场景二:乱码文件一键救急
- 痛点:同事发来的说明文档,打开是
鎷変綖鎷変綊一类的乱码。 - 操作路径:看状态栏当前编码 → 菜单栏「编码」→ 选择"转换编码"(如 GB18030 → UTF-8)→ 另存覆盖。
- 结果:同一份文件立即正常显示,状态栏同步变成 UTF-8,下次打开不会再乱。
场景三:两个文件版本对比合并
- 痛点:线上版和开发版各改了一部分,肉眼对不出差异在哪几行。
- 操作路径:菜单栏「对比」→「文件对比」,分别选定两个文件 → 差异行高亮 → 对需要采纳的差异执行合并/覆盖。
- 结果:只动该动的行,不用整文件复制粘贴,合并完状态栏的"未保存"标记会提醒你存盘。
卡住了看这里:问题速查
| 症状 | 原因 | 解决 |
|---|---|---|
| cmake 报找不到 Qt5 头文件 | 机器上只有 Qt 6 | brew link --force qt@5并重新指定CMAKE_PREFIX_PATH |
| 中文显示方块 | 文件编码非 UTF-8 或字体缺失 | 「编码」菜单转码;或brew install fontconfig && fc-cache -fv |
| 大文件打开卡顿或提示过大 | 默认文件/内存上限偏保守 | 调大 Performance 段的maxFileSize、memoryLimit |
| "来自未知开发者"打不开 | 无 Apple 公证签名 | 右键 Dock 图标选"打开",或在系统设置里放行一次 |
| 中文输入法偶发失效 | 焦点切换时机问题 | 点一下编辑区再输入;仍复现请到 更新日志 对照修复版本 |
快捷键与提速技巧一览
先记这几条,覆盖 80% 的日常操作(Mac 端均以 Cmd 为主键,均可在「设置」→ 快捷键中重新绑定):
| 功能 | 快捷键 |
|---|---|
| 新建文件 | Cmd + N |
| 查找 | Cmd + F |
| 保存当前文件 | Cmd + S |
| 保存全部 | Cmd + Shift + S |
| 撤销 | Cmd + Z |
| 关闭当前标签页 | Cmd + W |
进阶三招,都是"用过就回不去"的那种:
- 自定义语法高亮:「语言」→「自定义语言格式」,调整关键字颜色与样式,可导出成主题;
- 宏录制:把"格式化注释 + 加日期头"这类重复动作录一遍,之后一个快捷键完成;
- 文件浏览器侧边栏:左侧常驻常用目录树,配合"最近文件"列表,切项目基本不用 Finder。
更多界面细节可参考 项目文档。
Notepad-- 的体量和功能密度,对中文用户来说是很少见的平衡:编码问题交给它处理,你把注意力留给内容本身。接下来它有几个值得关注的方向:Apple Silicon 原生优化、集成终端、AI 辅助编辑。想跟进新版本的话:
cd notepad-- && git pull【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考