notepad-- 轻量文本编辑｜macOS 安装与上手完整指南-CSDN博客

notepad-- 轻量文本编辑｜macOS 安装与上手完整指南

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

notepad-- 是一个用 C++/Qt 编写的轻量级跨平台文本编辑器，定位是国产 Notepad 类编辑器的替代品。本文覆盖预编译包安装、源码编译两条路线和三个核心使用场景，不涉及插件开发。做完最后一步，你手上的 Mac 里就有能开文件、做差异对比、随时切编码且中文不乱码的编辑器。

动手前 30 秒：先判断你走哪条路

先自问三个问题：你的 Mac 装过 Xcode 命令行工具吗、平时会用终端吗？你要的是稳定发布版，还是 dev 分支里尚未发布的新功能？手上有管理员密码吗？

答案决定路线：

日常使用、只开存文件：直接走预编译包，5 分钟落地。
想要发布版之后才有的功能：用 CMake 从源码编译，耗时 30 分钟起。
想尝鲜未发布功能：流程同源码编译，只是把 clone 换成 dev 分支。
有指定 Qt 版本要深度定制：手动按序编译两个工程，1 小时起。

最快落地：预编译包安装（分步）

到官方发布页下载最新 macOS 压缩包（v3.x 系列）并解压。（检查点：解压结果里出现 NotePad--.app 文件夹）
打开访达侧边栏的「应用程序」文件夹，把 NotePad--.app 拖进去。（检查点：Applications 中多了新图标）
双击应用程序中的 notepad-- 启动。（检查点：若提示"无法验证开发者"，到「系统设置 → 隐私与安全性」点「仍要打开」）
等主窗口出现。（检查点：标题栏显示 Notepad--，菜单栏有文件、编辑、查找、编码、对比等完整菜单）

装完先别急着退出 👀 顺手做两件事：「文件」→「新建」输入一段中文保存，重新打开确认可读；「关于」菜单确认版本号弹窗（如 Version v2.9.0）。两项都过，安装没问题。

notepad-- macOS 版本号弹窗与多标签编辑界面

进阶编译：从源码到可执行文件

这条路线适合两类人：要发布版没有的新功能、以及准备改代码。前置要求是 CMake 3.16 以上与 Qt5，CMakeLists.txt 里声明了 Core、Gui、Widgets、Concurrent、Network、PrintSupport、XmlPatterns 共 7 个 Qt5 组件，缺任一都会编译失败。

xcode-select --install                                      # 安装 Xcode 命令行工具
brew install qt@5 cmake                                     # 安装 Qt5 与 CMake
git clone https://gitcode.com/GitHub_Trending/no/notepad--  # 拉取源码
cd notepad--
cmake -B build -DCMAKE_BUILD_TYPE=Release                   # 生成 Release 构建配置
cd build
make -j$(sysctl -n hw.ncpu)                                 # 按 CPU 核心数并行编译
sudo make install                                           # 安装，需要管理员密码

想尝鲜 dev 分支，只需把 clone 一行换成 git clone -b dev https://gitcode.com/GitHub_Trending/no/notepad--，其余完全一致。make install 完成后，可执行文件落在 bin，桌面条目与图标装到 /usr/share。

如果你要自带指定 Qt 版本，可绕开 CMake 用 Qt Creator：先编译 src/qscint/src/ 下的 qscintilla 依赖库，再编译主工程 src/RealCompare.pro，两个工程必须按序进行，参数细节见编译说明.docx。

装完先玩这三个场景

多标签编辑：多个文件并排打开

「文件」→「打开」选中多个文件，它们会以标签页形式并排挂在窗口顶部；左侧打开「目录列表」可以浏览当前目录下的内容。用惯之后，不用再在多个窗口之间来回切。

编码切换：修好旧 GBK 文档的乱码

从 Windows 带过来的旧文档常是 GBK 编码，打开直接就是满屏乱码。在「编码」菜单把当前文件切到 GBK 或 GB2312，屏幕上的中文立刻可读；也可以顺手把常用编码设为默认，下次打开不再乱码。窗口底部状态栏会常驻显示当前文件的编码与换行风格。

差异对比：改动逐行标出

「对比」菜单选择文件对比或目录对比，指定两个对比对象。差异行会在对比视图中逐行高亮；整个目录做对比时，哪些文件新增、删除、修改过一目了然。对比结果支持文件级下钻：选中一个有差异的文件，直接进入行级对比视图。

踩坑速查：症状 → 原因 → 一招解

⚠️ 以下都是高频问题，先对症状，再找解法：

双击预编译包提示"无法打开，因为无法验证开发者"：包没有 Apple 公证，Gatekeeper 默认拦截。到「系统设置 → 隐私与安全性」点「仍要打开」，或右键该应用选「打开」。
源码版一打开就闪退或提示缺库：Qt5 运行库没装全。确认 brew install qt@5 执行成功后，再用干净环境重试。
打开旧文档满屏乱码：文件本身是 GBK，编辑器按 UTF-8 读入了。在「编码」菜单手动切到对应编码，并把常用编码设为默认。
更新后行为和以前不一样：旧构建残留或分支代码变动。删掉本地 build 目录重新编译；预编译包用户直接换回旧版本发布包。
打开大文件明显卡顿：大文件被全量加载并逐行做语法高亮。在设置里调整大文件内存限制，或改用二进制模式打开查看。
源码编译时 cmake 提示版本过低：系统默认 CMake 太旧。执行 brew upgrade cmake 升到 3.16 以上再重新配置。

多数人用预编译包 5 分钟落地即可，追新功能或改代码再走上面的源码编译路线。版本功能清单见 changelog.txt，编译参数细节见编译说明.docx，项目背景见 README.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考