Notepad-- 跨平台文本编辑器：从安装到深度定制的完整上手指南-平芜编程栈

Notepad-- 跨平台文本编辑器：从安装到深度定制的完整上手指南

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

Notepad-- 是一款跨平台文本编辑器，一套代码跑在 Windows、Linux、macOS 三大平台上。下面这条路线从"跑起来"走到"调成自己的样子"：把命令敲完、把界面打开，最后它会变成你想要的样子。

离开 Windows 后，编辑器要跟着换

如果你在 Windows 上用惯了 Notepad++，换到 Linux 或 macOS 办公时，第一个不适应的就是编辑器带不走。Notepad++ 本身只支持 Windows，积累多年的操作习惯、菜单位置和快捷键，换平台后全部失效。Notepad-- 的定位就是在三个平台上给出同一套编辑体验：同一套界面、同一套快捷键、同一套行为，你切换系统后不需要重新学习。它是一款面向国产替代的文本编辑器，对 UOS 和各类 Linux 发行版做了重点适配。

把 Notepad-- 跑起来：三个平台一条主线 🖥️

三个平台的主线只有一条：拿到代码 → 编译 → 看到主界面。

Linux（Ubuntu / Debian / UOS）是最顺的一条路。先装依赖，再克隆编译：

sudo apt-get install g++ make cmake qtbase5-dev qtbase5-dev-tools qt5-qmake sudo apt-get install libqt5printsupport5 libqt5xmlpatterns5-dev git clone https://gitcode.com/GitHub_Trending/no/notepad-- cd notepad-- && cmake -B build -DCMAKE_BUILD_TYPE=Release cd build && make -j4

先apt-get装依赖 → 再git clone后cmake、make→make跑完没有报错，执行sudo make install，双击"notepad--"图标启动，看到带工具栏、标签页和编辑区的主界面，说明成功了。

Windows走开箱即用更省事：从项目发布页下载最新预编译安装程序，一路下一步装完即可。想改功能再走源码编译，用 Qt 5 + CMake 按 Linux 的步骤来，编译完cpack会打出 NSIS 安装包。

macOS同样可以直接下载预编译包使用；想自己编译就用 Qt 5 跑同一套 CMake 流程。macOS 版把菜单并进了系统顶栏，快捷键与 Windows 版保持一致。

Notepad-- 到底不一样在哪

目录级批量查找替换

场景：整个项目改了一个函数名，牵涉几十个文件。打开"查找 → 在目录查找"，填目标目录和关键词，勾上文件类型过滤（比如*.cpp *.h），点"全部替换"。可以设置跳过隐藏文件、跳过超过大小限制的文件。命中列表显示在底部结果区，点任意一条直接跳到对应行。效果：几百个文件一次替换完，每条命中都有记录，可逐条核对。

40 多种语言的语法高亮

内置的 Scintilla 词法引擎能识别 C++、Java、Python、JavaScript 等 40 多种语言，每种语言在主题里都有独立配色。打开文件即高亮，代码折叠和括号匹配一并生效。扩展名认不出来时，可以在"语言"菜单手动切换语言模式。效果：混合语言的工程不用手动选语言，编辑器按文件扩展名和内容自己认。

GB 级大文件处理

打开 GB 级的文本文件，先出现进度提示，文件过大时会弹出专门的提示框；加载完成后按可视区域做处理，滚动不卡。效果：日志、转储这类别的编辑器打不开的文件，在 Notepad-- 里能打开、能搜索、能定位。

把它调成自己的样子 🎨

定制分三层，从最直观到最费时间排下来。

改主题最直观：src/themes/目录下有 15 套内置主题，Black board、Deep Black、Obsidian 属深色系，Blue light、Choco、Monokai 属亮色系，lavender、misty rose 偏柔和。每套主题都按语言分了配色，在"设置"里选中即生效，界面立刻换脸。

QSS 样式有点门槛：界面样式用 Qt 的样式表语言写，语法类似 CSS。src/qss/目录里放了 myblack、flatgray、mystyle 等几套完整样式，改某个组件的背景色、字体、标签页外观都在这里动手。不熟悉语法就复制一份现成的 qss 改色值，别从零写。

重绑快捷键最费时间但最值：快捷键配置集中在 src/shortcutkeymgr.cpp，"设置 → 快捷键管理"里可以逐项改。建议先用默认键位跑一段时间，把最常用的（跳转行、批量替换）先改了，顺手再处理与系统热键的冲突。

你大概率会碰到的坑 ⚠️

编译报错，提示找不到 Qt5 或缺 PrintSupport——原因：Linux 上只装了 qtbase，缺 PrintSupport、XmlPatterns 组件。解法：装上libqt5printsupport5 libqt5xmlpatterns5-dev后重跑 cmake；Windows 编译失败则先确认 Qt 5 版本一致、工具链完整。

中文显示乱码——最高频的一个。原因：文件实际是 GB18030/GBK 编码，却按 UTF-8 打开了。解法：看状态栏的编码显示，用"编码 → 转换编码"切过去再保存。它也支持自动检测编码和行尾转换（CRLF / LF / CR）。

大文件打开慢、卡住——原因：打开时后台要做语法高亮和文件解析，大文件耗时。解法：设置里开快速加载，超大文件临时关掉高亮和代码折叠。

插件加载失败——别慌，多数是版本问题：插件的 Qt 版本和主程序不一致，或 API 不兼容。解法：用与主程序相同的 Qt 5 版本重编插件。插件接口在 src/nddpluginapi.h，src/plugin/helloworld/是拿来就能编的示例。

快捷键冲突，菜单点了没反应——原因：热键和系统或输入法撞了。解法：打开快捷键管理，看冲突列表，换一个没被占用的组合。