Notepad--快速上手教程：几分钟从0到能用的新手指南

Notepad--快速上手教程：几分钟从0到能用的新手指南

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

Notepad--（ndd）是一款支持 Windows、Linux、macOS 的轻量级跨平台文本编辑器，由国内开发者打造，内置多编码切换、批量查找替换、文件对比等能力，适合日常文本处理和轻量代码编辑。本文带你从克隆源码、编译启动，到完成三项基础设置，再实战批量替换、文件对比等高频场景。

从源码到启动窗口

前置条件：系统已安装 CMake 3.16 以上版本和 Qt5 开发环境（CMakeLists.txt 中要求 Qt5 的 Core、Gui、Widgets 等模块）。

1. 获取源码：

git clone https://gitcode.com/GitHub_Trending/no/notepad--

执行完你应该看到当前目录下多出一个 notepad-- 文件夹，里面有 src、cmake、pngshow 等子目录。

2. 编译项目：

cd notepad-- cmake . make

执行完终端会滚动大量编译输出，全部结束且没有 error 时，项目根目录会生成名为 NotePad-- 的可执行文件。

3. 启动编辑器：

./NotePad--

执行完你应该看到编辑器主窗口弹出：顶部是菜单栏，中间是标签页和编辑区，底部是状态栏。

图：notepad-- 主界面，顶部菜单栏、中央编辑区与标签页布局一览

第一次打开，先把这三项调好

菜单栏包含 文件、编辑、查找、视图（View）、语言（Language）、设置（Set）、工具（Tools）、插件（Plugin）等入口。建议先完成下面三项。

1. 把界面切成中文

1. 打开顶部的【语言】（Language）菜单
2. 选择简体中文
3. 若个别菜单项仍是英文，重启程序让它完全生效

图：notepad-- 语言设置界面，可切换界面显示语言

2. 调整图标大小

1. 打开【视图】菜单
2. 进入【Icon Size】子菜单
3. 在 24、36、48 三档中选择一挡

设置后工具栏和菜单图标会立刻变成对应尺寸，48 适合大屏，24 适合小屏。

3. 认清编码显示

编码决定文件里中文能否正常显示。打开任意文件后，状态栏会显示当前编码，也可以在【视图】→【E&ncoding】菜单里查看和切换，支持 UTF-8、GBK、Big5 等常用编码。新建文档默认使用 UTF-8，一般无需改动。

💡 打开文件发现中文是乱码时，先别急着保存，切编码直到显示正确再动手。

实战：三个最高频的使用场景

在目录里批量查找与替换文件内容

你要做什么：把某个目录下几十个文件里的同一个词一次性改掉。

1. 打开【工具】菜单，点击【Batch Find】
2. 在弹出的批量查找窗口中选择目标文件夹
3. 输入查找内容和替换内容
4. 点击全部替换

做完会看到：结果区列出所有被修改的文件，批量替换带有进度条，你可以清楚知道哪些文件被改动了。

图：notepad-- 批量查找替换界面，支持对目录内多个文件同时处理

对比两个文件的差异

你要做什么：找出两份内容（比如修改前后的配置、两个版本的脚本）到底差在哪。

1. 用标签页分别打开两个要对比的文件
2. 右键其中一个标签，点击【Select Left Cmp File】
3. 右键另一个标签，点击【Select Right Cmp File】
4. 等待对比完成，进入对比视图

做完会看到：左右两侧并排显示两个文件，差异行用不同颜色高亮，可以用界面提供的上一处/下一处按钮逐段跳转差异位置。

图：notepad-- 文件对比界面，两侧差异内容用颜色高亮标出

一键格式化 XML 或 JSON 文件

你要做什么：把挤成一团的 XML、JSON 文件整理出清晰的层级缩进。

1. 打开对应的 XML 或 JSON 文件
2. 打开【工具】菜单
3. 点击【Format Xml】或【Format Json】

做完会看到：编辑区里的文件按层级重新缩进，结构一眼可读。

效率小贴士

• 按 Ctrl+F 打开查找框，选中的文字会自动带入查找内容
• 按 Ctrl+H 打开查找与替换
• 按 Ctrl+F2 给当前行加书签，F2 / Shift+F2 在书签之间前后跳转
• 右键点击标签页，可关闭其他文档、重命名、在新窗口打开
• 右键标签页选择【Reload With Hex Mode】，以十六进制模式查看文件
• 文本中的网址会高亮显示，双击直接打开

避坑指南

现象：打开旧文件中文全是乱码原因：文件实际是 GBK 或 Big5 等编码保存的，和编辑器当前使用的编码不一致。 解决：在【视图】→【E&ncoding】里切换编码直到显示正常，确认无误后再保存；需要共享给更多人时建议统一存成 UTF-8。

现象：cmake 报 "Could NOT find Qt5" 错误原因：系统缺少 Qt5 开发包，或 CMake 版本低于 3.16。 解决：先用包管理器装好 qtbase5-dev 和 cmake（Debian/Ubuntu 可用sudo apt install qtbase5-dev cmake make），再重新执行 cmake 和 make。

现象：打开很大的文本文件时弹出选择框或反应缓慢原因：编辑器对大文本、超大文本提供了不同的打开方式（见 bigfilemessage.cpp）。 解决：按弹窗提示选择打开方式即可，不要强求所有大文件都用完整功能加载。

写在最后

到这里，你已经能让 Notepad-- 跑起来，并掌握语言设置、批量替换和文件对比这些日常最常用的操作。下一步可以翻翻 changelog.txt 了解各版本的新功能，或看看 src/plugin/ 目录了解插件是怎么写的。

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