macOS 安装 notepad-- 完整指南:5 分钟装好跨平台文本编辑器
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
Mac 自带的文本编辑够不着,VS Code 又嫌重?notepad-- 就是一个折中答案:国产团队用 C++/Qt 写的跨平台轻量文本编辑器,Windows、Linux、macOS 共用一套代码,自带语法高亮、GBK/UTF-8 编码切换、文件与目录差异对比。这篇指南带你把它装进 Mac,并跑通第一次上手的全部动作。
先认识一下 notepad--
- 定位「Notepad 类」轻量编辑器的跨平台替代,主打 macOS、Linux 与国产信创系统
- 语法高亮由内置的 qscint 模块(Qt 版 Scintilla 引擎)驱动,覆盖上百种语言
- 中文编码是强项:GBK、GB2312、UTF-8 随时切换,老文档不乱码
- 文件和目录差异对比是招牌功能,改动行逐行标红
notepad-- 在 macOS 上的多标签文本编辑界面
选条安装路:先答三个问题
不确定的时候,按这三个问题对号入座:
- 只想马上能用,还是想追最新功能甚至改代码?
- 电脑上装过 Homebrew 吗?
- 手头有管理员密码吗(源码安装的最后一步要用)?
| 安装路径 | 耗时 | 前置要求 | 适合谁 |
|---|---|---|---|
| 预编译包 | 约 5 分钟 | 无 | 日常使用,装完即用 |
| Homebrew | 约 10 分钟 | 已装 Homebrew | 希望以后brew upgrade省心 |
| 源码编译 | 30 分钟起 | Xcode 命令行工具 + Qt5 | 追最新版、准备二次开发 |
| 开发分支 | 同源码编译 | 同源码编译 | 尝鲜未发布功能 |
| 手动编译 | 1 小时起 | 自备指定版本 Qt | 深度定制、针对 Apple Silicon 优化 |
答不出「我要改代码」,就直接看下一节的预编译包路线,这是推荐路径。
📦 推荐路径:预编译包四步装好
- 到仓库的 Releases 页下载最新 macOS 压缩包(当前发布线为 v3.x),双击解压,得到
NotePad--.app。 - 把
NotePad--.app拖进访达侧边栏的「应用程序」(即/Applications),正式落位。 - 在启动台里找到 notepad-- 双击运行。
- 预期结果:窗口标题栏显示
Notepad--,文件、编辑、查找、编码、对比等菜单齐全,新建一个.txt能正常输入中文。
其他路径,各用几行说清
- Homebrew:
brew install notepad--一条命令装好;以后升级执行brew upgrade notepad--即可。 - 源码编译:仓库要求 CMake 3.16 以上与 Qt5(CMakeLists.txt 里声明了 Core、Widgets、PrintSupport 等组件),核心命令就四条——
xcode-select --install # 安装 Xcode 命令行工具 brew install qt@5 cmake ninja # 装 Qt5 与编译工具链 git clone https://gitcode.com/GitHub_Trending/no/notepad-- && cd notepad-- cmake -S . -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j && sudo cmake --install build预期结果:build目录生成NotePad--可执行文件(项目版本 1.22.0),安装后附带桌面文件。
- 开发分支:clone 时换成
git clone -b dev,其余步骤不变。 - 手动编译:自己下载指定版本 Qt、调整 CMake 参数并做芯片优化,细节配合 编译说明.docx 逐步配。
验证装对了:版本号和中文读写
- 菜单栏点「关于」,弹窗会显示版本号(例如
Version v1.23.2)——看到它,说明二进制真的跑起来了。 - 新建文件输入一段中文,保存后用系统「文本编辑」打开确认不乱码;再切到 GBK 编码存一次,验证编码切换。
- 装错的特征:双击没反应 → Gatekeeper 拦截,去「系统设置→隐私与安全性」点「仍要打开」;源码版一打开就闪退或报缺库 → 多半是 Qt5 运行库没装全,回头检查
brew install qt@5是否成功。
notepad-- macOS 文本编辑器关于版本弹窗,显示版本号
首次启动后值得做的 5 件事
- 开多标签:文件→打开,多个文件以标签页并排,不用再来回切窗口。
- 定默认编码:编码菜单里把默认设为 UTF-8;状态栏右下角还能对单个文件手动切 GBK。
- 试一次差异对比:「对比」菜单选文件对比或目录对比,改动行逐行标红,是它最招牌的能力。
- 批量查找替换:查找菜单进批量窗口,支持目录级搜索、正则和按文件类型过滤。
- 挑一套主题:设置里切换界面与配色,src/themes/ 下内置 Monokai、Obsidian、Bespin 等多套语法配色。
- (可选)装插件:插件菜单加载已编译插件;想自己写,看 插件编程开发说明.docx。
问题速查
| 现象 | 多半原因 | 处理 |
|---|---|---|
| 双击提示「无法验证开发者」 | 预编译包未经 Apple 公证,Gatekeeper 拦截 | 系统设置→隐私与安全性→「仍要打开」,或先右键该 App 选「打开」 |
| 打开旧文档满屏乱码 | 文件本身是 GBK,被按 UTF-8 读入 | 编码菜单手动切回对应编码,再把常用编码设为默认 |
| 更新后行为变了 | 旧构建残留,或分支代码有变动 | 源码版git pull后重编;Homebrew 用户brew upgrade notepad-- |
| 插件加载失败 | 插件与主程序版本不匹配 | 核对插件要求的主程序版本,用同版本源码重编插件 |
| 打开大文件卡顿 | 大文件全量加载并逐行做语法高亮 | 设置里调大文件的内存与缓存限制,或改用二进制模式查看 |
下一步
想深入就逛一逛功能源码 src/,或从 RealCompare.pro 入手了解工程组织。版本历史看 changelog.txt,项目说明见 README.md,英文介绍见 README_EN.md。遇到 bug 或有功能建议,直接在仓库提 issue 反馈即可。
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考