如何在 macOS 上安装 notepad-- 文本编辑器：完整教程
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器，目标是做中国人自己的编辑器，来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
notepad-- 是一款跨平台文本编辑器，Windows、Linux、macOS 三端同一套代码。这篇安装教程讲它在 Mac 上怎么落地：不动代码的人装预编译包，会编译的人直接从源码出包。按步骤做完，你能确认版本装对了、中文不乱码，并且把常用功能用起来。
项目 30 秒速览
- 国产团队用 C++/Qt 写的轻量编辑器，定位是 Notepad 类软件的跨平台替代
- 核心场景：日常文本编辑、上百种语言的代码浏览（语法高亮）、文件与目录差异对比
- 中文编码处理是重点，GBK、GB2312、UTF-8 等常见编码可随时切换
- 适合"嫌 TextEdit 太弱、又嫌 VS Code 太重"的人
选择你的安装路径
先问自己三个问题：会不会终端操作？要不要最新版？手上有没有管理员密码？答案对应下面四条路。
| 安装方式 | 时间成本 | 前置要求 | 适用场景 | 潜在风险 |
|---|---|---|---|---|
| 预编译包 | 约 5 分钟 | 无 | 日常使用，装完就完 | 版本可能落后于开发分支 |
| Homebrew | 约 10 分钟 | 已安装 Homebrew | 希望以后brew upgrade省心 | 受公式源更新节奏影响 |
| 源码编译 | 30 分钟起 | Xcode 命令行工具 + Qt5 | 要最新版、或以后改代码 | 需要管理员密码，编译环境需排错 |
| 开发分支 | 同源码编译 | 同源码编译 | 尝鲜未发布功能 | 稳定性无保证 |
| 手动编译 | 1 小时起 | 自行准备指定版本 Qt | 深度定制、针对 M 系列芯片优化 | 配置项多，容易卡壳 |
安装步骤
预编译包：拖进「应用程序」即可启动
多数人选这条路，四步：
- 从官方仓库的 Releases 页面下载最新 macOS 压缩包（当前发布线为 v3.x），下载完双击解压，得到
NotePad--.app。 - 把
NotePad--.app拖进/Applications（访达侧边栏的"应用程序"），相当于正式落位。 - 在启动台找到 notepad-- 双击运行；如果系统弹出拦截提示，参考下方"避坑"第一条处理。
- 预期结果：窗口标题栏显示
Notepad--，文件、编辑、查找、编码、对比等菜单齐全，新建一个.txt能正常输入中文。
源码编译：用 CMake 出最新包
想要发布版之后的新功能、或准备二次开发，就走这条。仓库要求 CMake 3.16 以上和 Qt5（CMakeLists.txt 里声明了 Core、Widgets、PrintSupport 等组件）。
# 装 Xcode 命令行工具与编译依赖 xcode-select --install brew install qt@5 cmake ninja# 取源码 git clone https://gitcode.com/GitHub_Trending/no/notepad-- cd notepad--# 配置并编译，-j 参数让多核并行 mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release make -j$(sysctl -n hw.ncpu) sudo make install预期结果：build目录生成NotePad--可执行文件，CMake 项目版本号当前为 1.22.0；make install会把它放进bin并附带桌面文件。
Homebrew 一条命令装 notepad--
环境干净、以后想自动升级时选它：
brew install notepad--开发分支与手动编译：留给深度玩家
- 开发分支：把上面的 clone 命令换成
git clone -b dev https://gitcode.com/GitHub_Trending/no/notepad--，其余步骤不变。 - 手动编译：自行下载指定版本 Qt、调整 CMake 参数、针对 Apple Silicon 芯片做优化编译，适合要深度定制的人；细节可结合 编译说明 逐步配。
验证安装成功：看版本号与中文读写
- 打开 notepad--，点菜单栏"关于"，弹窗会显示版本号（如
Version v1.23.2）——看到它即说明二进制跑起来了。 - 新建文件，输入一段中文，保存后用系统"文本编辑"打开确认不乱码，再换 GBK 编码保存一次，验证编码切换。
- 失败怎么判断：双击没反应 → Gatekeeper 拦截，走避坑第一条；源码版一打开就闪退或提示缺库 → 多半是 Qt5 运行库没装全，回上一步检查
brew install qt@5是否成功。
notepad-- macOS 版本信息弹窗
首次启动后的 5 件事
notepad-- macOS 多标签编辑界面
- 开多标签：文件→打开，多个文件以标签页并排，别再用窗口来回切。
- 定默认编码：编码菜单里把默认设为 UTF-8；状态栏右下角还能对单个文件手动切 GBK。
- 试一次差异对比：对比菜单里选文件对比或目录对比，改动行会逐行标红。
- 批量查找替换：查找菜单进入批量窗口，支持目录级、正则和按文件类型过滤。
- 挑一套主题：设置里切换界面与配色，仓库
src/themes/下内置 Monokai、Obsidian、Bespin 等多套语法配色。 - 装插件（可选）：插件菜单加载已编译插件，想自己写的话看 插件编程开发说明。
避坑：高频问题排查
现象：双击后提示"无法打开，因为无法验证开发者"。原因：预编译包未经过 Apple 公证，Gatekeeper 默认拦截。解决：系统设置→隐私与安全性→点"仍要打开"，或先右键该 app 选"打开"。
现象：打开旧文档满屏乱码。原因：文件本身是 GBK，编辑器按 UTF-8 读入了。解决：编码菜单手动切到对应编码，再把常用编码设为默认。
现象：更新后行为变了，想回到旧状态。原因：源码版覆盖安装后残留了旧构建，或分支代码有变动。解决：
git pull后重新编译；Homebrew 用户执行brew upgrade notepad--。现象：插件加载失败或被拒绝。原因：插件与主程序版本不匹配。解决：核对插件要求的主程序版本，用同版本源码重新编译插件再加载。
现象：打开大文件明显卡顿。原因：大文件全量加载并逐行做语法高亮。解决：在设置里调整大文件的内存与缓存限制，或改用二进制模式打开查看。
写在最后
多数人用预编译包就够了，五分钟落地；要追最新版或打算改代码，就走上面的 CMake 源码编译流程，环境细节可再查 编译说明 和 README。遇到 bug 或功能建议，直接在仓库提 issue 反馈。版本历史看 changelog.txt。
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器，目标是做中国人自己的编辑器，来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
