Audiveris 的 .zip 归档：训练样本仓库（samples/images/annotations）的结构、用途与运维
2026/10/4 10:45:16
简介：这份文档面向希望在 Mac 电脑上使用 Notepad++ 的用户，尤其是习惯该编辑器却受限于 macOS 平台的开发者与办公人群。由于 Notepad++ 官方并未推出 Mac 版本，资源借助 WineBottler 这一开源 Wine 前端，给出在 Mac 上运行 Windows 应用的可行路径，并完整梳理从下载、复制应用到命名、运行与更新的操作流程，同时补充了 Notepad++ 的核心功能说明，如内置 27 种语法高亮、自定义语言、自动检测文件类型、节点折叠、缩进引导线、双窗口与多子窗口、F11 全屏切换、鼠标滚轮缩放、邻行互换与宏功能、选中文本字节数显示等。资源包共 1 个 docx 文件，约 357KB，内容精炼、步骤清晰，适合作为 Mac 用户跨平台使用 Notepad++ 的入门参考。目前已有 2640 人学习，便于快速对照操作并了解编辑器能力边界。
1. Notepad++ 在 Mac 上的真实处境：为什么没有官方 dmg，替代路径怎么选
如果你是从 Windows 迁到 Mac 的开发者，第一反应往往是去搜「Notepad++ Mac 版怎么安装」，然后发现官网下载页只有 Windows 的 exe 和 zip，根本没有 dmg。这不是你找错了地方，而是 Notepad++ 本身基于 Win32 API 和 Scintilla 控件构建，官方从未发布过原生 macOS 版本。标题里那个.docx后缀大概率是有人把安装说明写成了 Word 文档在群里传，但核心诉求是一样的：我就要在 Mac 上用 Notepad++，或者至少找一个操作逻辑接近的替代品。
这篇文章面向三类人：刚换 Mac 想延续 Windows 编辑习惯的开发者、需要批量处理文本但不想开重型 IDE 的运维、以及被「Mac 安装 Homebrew 失败」卡住后想找另一条路的人。我会把可行路径按「还原度」和「折腾成本」排开，每条都给出可复现的命令和参数，最后告诉你哪条路值得走、哪条路趁早放弃。
2. 三条可行路径的选型逻辑与最小验证
2.1 为什么 Wine 方案能跑但我不推荐日常用
Wine 是一个在 Unix 系统上实现 Windows API 的兼容层，理论上能让 Notepad++ 的 exe 直接运行。常见做法是用 Homebrew 装wine-stable，然后下载 Notepad++ 的便携版 zip 解压运行。先看最小验证命令：
# 安装 Wine（Intel Mac 和 Apple Silicon 路径不同，先确认架构） uname -m # 输出 arm64 说明是 Apple Silicon，需要 Rosetta 或 crossover 方案 # 输出 x86_64 说明是 Intel Mac，可直接走 wine-stable # Intel Mac 安装命令 brew install --cask wine-stable # 验证 Wine 是否可用 wine --version逻辑说明：uname -m是第一步，因为 Apple Silicon 上原生 Wine 支持很差，必须通过 Rosetta 2 转译，而 Rosetta 对 Win32 程序的兼容性会再打一层折扣。brew install --cask wine-stable装的是稳定版，不要用wine-staging，后者虽然新特性多但崩溃率明显更高。
参数说明：Notepad++ 便携版解压后目录里有个notepad++.exe，启动命令是wine notepad++.exe。如果报err:module:import_dll之类的错，说明缺 Visual C++ 运行库，需要额外winetricks vcrun6。这套方案能跑起来，但中文输入法候选框会漂移、插件管理器大概率白屏、大文件打开超过 50MB 容易卡死。我实测过三轮，结论是：能应急，不能当主力。
2.2 用 Homebrew 装原生替代品：从 notepad-- 到 CotEditor
如果你要的是「Notepad++ 的操作手感」，Mac 上有几个原生替代品还原度很高。先解决一个高频卡点：很多人搜「mac 安装 brew」或「mac 安装 homebrew 失败」，其实是因为没配国内镜像或 Xcode Command Line Tools 没装。先跑这两条：
# 第一步：装命令行工具，这是 Homebrew 的前置依赖 xcode-select --install # 第二步：如果官方脚本卡住，用国内镜像装 Homebrew /bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"逻辑说明：xcode-select --install会弹窗让你确认安装，装完后git和clang才可用，Homebrew 的安装脚本依赖这两个。国内镜像脚本会引导你选源，选清华或中科大都可以，装完后brew --version能输出版本号就说明通了。
装好 Homebrew 后，原生替代品按还原度排序：
| 替代品 | 安装命令 | 还原度 | 适合场景 |
|---|---|---|---|
| notepad-- | brew install --cask notepad-- | 高 | 国产，界面和快捷键几乎照搬 |
| CotEditor | brew install --cask coteditor | 中 | 轻量，Mac 原生体验好 |
| VS Code | brew install --cask visual-studio-code | 中 | 插件生态强，但启动重 |
| Sublime Text | brew install --cask sublime-text | 中高 | 大文件快，正则强 |
notepad-- 是国内开发者做的，菜单结构、快捷键、甚至「查找替换」的对话框布局都和 Notepad++ 一致，迁移成本最低。CotEditor 胜在原生，启动秒开，但正则语法和 Notepad++ 有差异。VS Code 不用多说，但如果你只是改个配置文件，等它加载完插件的时间够 CotEditor 改三遍了。
2.3 插件生态的替代：Python Script 在 Mac 上怎么落地
Notepad++ 的 Python Script 插件是很多人离不开它的原因，热搜里「notepad++ 插件 python script 用法」出现频率很高。Mac 替代品里，VS Code 的 Python 扩展能覆盖大部分场景，但如果你要的是「选中文本 → 跑一段 Python → 替换回编辑器」这种即时脚本，CotEditor 的脚本菜单更接近。
CotEditor 支持把 Python 脚本放到~/Library/Application Support/CotEditor/ScriptMenu/目录，脚本通过标准输入读选中文本，标准输出写回编辑器。最小示例：
#!/usr/bin/env python3 # 保存为 ~/Library/Application Support/CotEditor/ScriptMenu/upper.py # 功能：把选中文本转大写 import sys text = sys.stdin.read() sys.stdout.write(text.upper())逻辑说明：CotEditor 会把当前选中的文本通过 stdin 传给脚本，脚本处理完写到 stdout，编辑器自动替换选区。sys.stdin.read()读全部输入，sys.stdout.write()输出结果，不要用print，因为print会多加一个换行符。
参数说明：脚本文件需要chmod +x加执行权限，否则 CotEditor 菜单里会灰掉。这个机制和 Notepad++ Python Script 的editor.getSelText()/editor.replaceSel()思路一致，只是接口从 API 调用变成了标准流。如果你有大量现成的 Notepad++ Python 脚本，迁移时需要把editor.开头的调用改成 stdin/stdout 读写，逻辑部分基本不用动。
3. 避坑：Mac 上折腾 Notepad++ 替代方案的 5 个血泪教训
3.1 现象：Homebrew 装到一半报错Failed to connect to raw.githubusercontent.com
原因：官方安装脚本要从 GitHub 拉文件，国内网络环境下大概率超时。这不是你 Mac 的问题，是网络路径的问题。
解决：不要反复重试官方脚本，直接用国内镜像脚本重装。如果已经装了一半，先跑/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"里的卸载选项清干净再装。装完后brew doctor检查一遍，有警告按提示处理。
3.2 现象：Wine 方案下 Notepad++ 能打开但中文全是方块
原因：Wine 默认不带中文字体映射，Notepad++ 找不到系统里的中文字体。
解决：把 Mac 的字体目录链接到 Wine 的字体目录，命令是ln -s /System/Library/Fonts /Users/你的用户名/.wine/drive_c/windows/Fonts，然后在 Notepad++ 设置里手动指定字体为「PingFang SC」或「Heiti SC」。这个坑我踩过两次，第一次以为是编码问题，折腾半天编码设置，最后发现是字体缺失。
3.3 现象：notepad-- 装完后右键菜单没有「用 notepad-- 打开」
原因：Homebrew cask 安装的 app 不会自动注册右键菜单服务。
解决：打开 notepad--，在偏好设置里找「关联文件类型」或「注册右键菜单」选项，勾选后重启 Finder。如果 app 本身没提供这个选项，可以用automator建一个快速操作，或者装brew install --cask syntax-highlight这类工具辅助。注意不要手动去改/System/Library/Services/下的文件，macOS 的 SIP 会拦。
3.4 现象：CotEditor 脚本菜单里 Python 脚本是灰色的点不了
原因：脚本文件没有执行权限，或者 shebang 行写的解释器路径不对。
解决：先chmod +x ~/Library/Application Support/CotEditor/ScriptMenu/你的脚本.py，然后确认第一行是#!/usr/bin/env python3而不是#!/usr/bin/python。Mac 从 12.3 开始移除了系统自带的 Python 2，写python会找不到解释器。如果你用 pyenv 或 conda 管理 Python，shebang 要写对应的绝对路径。
3.5 现象：VS Code 打开大文件卡死，任务管理器显示 CPU 跑满
原因：VS Code 基于 Electron，默认会对整个文件做语法高亮和 token 分析，文件超过 100MB 时内存暴涨。
解决：在设置里搜files.maxMemoryForLargeFilesMB，默认是 4096，改成 8192 或更高。另外打开大文件时先用code --disable-extensions启动，排除插件干扰。如果经常处理 GB 级日志，别用 VS Code，用less或lnav更实际。这个坑的本质是工具选型问题，不是配置能完全解决的。
4. 进阶：用命令行把 Notepad++ 的核心工作流搬到 Mac
如果你最终接受「Mac 上没有 Notepad++」这个事实，但又不想放弃它的核心工作流，可以把常用操作拆成命令行组合。Notepad++ 最高频的三个场景是：批量查找替换、编码转换、行操作。Mac 上用sed、iconv、awk能覆盖九成需求。
先看批量查找替换。Notepad++ 的「在文件中查找替换」对应的是sed加find：
# 在当前目录所有 .conf 文件里，把 old_server 替换成 new_server # -i 表示原地修改，macOS 的 sed 需要给 -i 指定备份后缀，这里用空字符串 find . -name "*.conf" -type f -exec sed -i '' 's/old_server/new_server/g' {} + # 如果要先预览再替换，去掉 -i '' 部分，输出到终端确认 find . -name "*.conf" -type f -exec sed 's/old_server/new_server/g' {} +逻辑说明：find . -name "*.conf" -type f找出当前目录及子目录下所有 .conf 文件，-exec把结果逐个传给sed，{} +表示批量传递而不是逐个启动进程，效率更高。sed -i ''是 macOS 特有的写法，Linux 上直接sed -i就行，这是跨平台脚本最常见的翻车点。
参数说明：s/old/new/g里的g表示全局替换，不加只替换每行第一个匹配。如果替换内容含斜杠，把分隔符换成|，写成s|old/path|new/path|g。涉及正则特殊字符时，sed的 BRE 和 Notepad++ 的 PCRE 有差异，复杂正则建议先用perl -pe验证。
再看编码转换。Notepad++ 的「编码」菜单对应iconv：
# 把 GBK 编码的文件转成 UTF-8 iconv -f GBK -t UTF-8 input.txt -o output.txt # 批量转换当前目录所有 .txt for f in *.txt; do iconv -f GBK -t UTF-8 "$f" -o "${f%.txt}_utf8.txt" done逻辑说明：iconv -f指定源编码，-t指定目标编码，-o指定输出文件。不指定-o会输出到终端。批量循环里${f%.txt}是去掉后缀，拼上_utf8.txt避免覆盖原文件。
参数说明：如果报illegal input sequence，说明源文件里有不符合 GBK 的字节，加-c参数忽略非法字符，但会丢数据，建议先备份。Mac 上iconv支持的编码用iconv -l查，GB18030 比 GBK 覆盖更全，优先用 GB18030。
最后是行操作。Notepad++ 的「删除空行」「排序行」「去重」对应：
# 删除空行 sed '/^$/d' input.txt > output.txt # 排序并去重 sort -u input.txt > output.txt # 给每行加行号 awk '{print NR": "$0}' input.txt > output.txt逻辑说明：sed '/^$/d'匹配空行并删除，sort -u排序同时去重，awk '{print NR": "$0}'里NR是行号，$0是整行内容。这三个组合基本覆盖了 Notepad++ 行操作菜单的常用项。
参数说明：sort默认按字典序，要按数字排序加-n，要按版本号排序加-V。awk的行号从 1 开始，如果要补零对齐用printf "%04d: %s\n", NR, $0。
我自己的习惯是：把这三组命令写成 shell 函数放在~/.zshrc里，用alias起短名，比如alias replace='sed -i ""'，日常改配置比开编辑器快得多。折腾 Notepad++ Mac 版这件事，最后教会我的不是怎么装 Wine，而是把「编辑器依赖」拆成「命令行能力」——一旦拆开，换什么系统都不慌。希望帮到你。
本文还有配套的精品资源，点击获取