企业官网建设流程全解析

Notepad-- Mac 安装教程：两条路线让轻量级文本编辑器跑起来

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

给 macOS 装一个 Notepad-- 并不麻烦，它是一款用 Qt 打造的轻量级文本编辑器，Mac 安装有两条路线，源码编译和现成包各走各的。如果你在 Mac 上常处理 GBK/GB18030 中文文件、想要一个多标签、带文件对比的编辑器，这篇就走完：选路线、执行、验证、排错、调优。

如何选对安装路线

不碰代码就直接走路线B；想试最新功能或自己改东西，再上路线A。

路线A：macOS 源码编译

先确认环境：macOS 10.14 及以上，Intel 或 Apple Silicon（M1/M2）均可，4GB 内存、10GB 空闲磁盘。依赖上认准 Qt 5，Qt 6 有兼容问题不建议用，外加 CMake。

安装 Xcode 命令行工具并装好 Qt5 依赖（brew install qt@5是编译的核心前提）：

xcode-select --install brew install qt@5 cmake ninja

把源码拉到本地：

git 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)

说明一下参数：-DCMAKE_PREFIX_PATH指向 Homebrew 的 Qt5 安装位置，-j用满 CPU 核心数。💡 qscintilla 编辑库在 CMake 里作为静态库随主工程一起编译，不用单独再跑 qmake。编完直接在 build 目录运行生成的NotePad--可执行文件即可，不必装进系统。

路线B：现成安装包

1. 到项目发布页下载 macOS 对应架构的.dmg文件；
2. 双击打开磁盘映像，把 Notepad-- 拖进 Applications；
3. 首次启动右键图标选"打开"，通过系统信任提示即可。

Notepad-- macOS 查找替换界面

装完怎么验证

打开后做三件事：

1. 看版本：菜单"关于"里确认版本号，路线A应显示源码最新版的号；
2. 查编码：新建文件输入中文存成 UTF-8，再打开一个 GBK/GB18030 文件，看"编码"菜单能否正确识别并转换——这是 Notepad-- 的核心卖点；
3. 试输入法与快捷键：编辑器里直接输入中文，按Cmd+F确认查找替换窗口弹出。

三项都通过，就算装好了。

卡住了？对症排查

编译卡在 Qt 版本报错

多半是 Qt5 和 Qt6 冲突，先把 Qt5 强关联出来再重新配置：

brew link --force qt@5 export PATH="$(brew --prefix qt@5)/bin:$PATH"

还报找不到 Qt，就检查CMAKE_PREFIX_PATH指向的目录是否真实存在。

中文显示乱码

分两种：文件本身不是 UTF-8，用"编码"菜单转成 GBK/GB18030 再打开；系统缺字体，则brew install fontconfig后执行fc-cache -fv刷新，再重启程序。

大文件打开卡顿

在"设置"里调一下最大文件大小限制等性能参数；超大文件可以改用十六进制视图模式打开。

装完之后的顺手优化

• 默认编码与字体：都在"设置"菜单里改默认保存编码、编辑字体和编码自动识别；
• 图标资源：macOS 图标在src/macicon/下，一般不用动；
• 插件：1.21 起支持动态插件，示例工程在src/plugin/helloworld/，想扩展功能可以从这里抄起。

常用快捷键：

想继续深入，仓库根目录的 编译说明.docx 和 README.md 有更细的构建与插件开发资料。Notepad-- 本身是跨平台项目，Mac 上跑顺了，后面换机器也不成问题。

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