ruby命令需在cmd中直接运行,notepad++依赖系统环境;配置run命令为ruby "$(full_current_path)"并保存快捷键;脚本首行需设utf-8编码;运行前必须手动保存文件。

确认 ruby 命令能在 CMD 中直接运行
这是所有配置的前提,跳过这步,后面全白搭。Notepad++ 本身不带 Ruby 解释器,它只是调用系统命令行去执行 ruby 命令。
打开 CMD,输入:
ruby -v
如果返回版本号(如 ruby 3.1.4),说明已就绪;若报错 'ruby' 不是内部或外部命令,请重装 RubyInstaller,并勾选 Add Ruby executables to your PATH。装完必须重启 Notepad++——它启动时就缓存了环境变量,只重启 CMD 没用。
用 Run 菜单配最简命令:ruby "$(FULL_CURRENT_PATH)"
这是轻量、稳定、可预测的方案,比插件更可靠。打开 运行 → 运行…(F5),输入:
ruby "$(FULL_CURRENT_PATH)"
注意三点:
-
"$(FULL_CURRENT_PATH)"必须带双引号,否则路径含空格或中文时会失败 - 不能写成
$(FULL_CURRENT_PATH)(缺引号)或"$FULL_CURRENT_PATH"(语法错误) - 别用
py -3那类启动器替代ruby,Notepad++ 的 Run 系统不解析 shebang
保存为快捷键(比如 F6),名字叫 Run Ruby 即可。
中文输出乱码?优先在脚本里设编码,而非改 CMD
Windows 控制台默认 GBK,Ruby 默认 UTF-8 输出,直接运行会显示 。临时解决可用:
chcp 65001 && ruby "$(FULL_CURRENT_PATH)"
但更稳的做法是在 Ruby 脚本第一行加:
Encoding.default_external = Encoding::UTF_8<br>Encoding.default_internal = Encoding::UTF_8
尤其 Ruby 2.4+ 必须显式设置,否则 gets 或读文件可能出错。别动系统区域设置,副作用大;也别指望 NppExec 的“Console Output → UTF-8”能彻底解决交互输入问题——它对 STDIN.read 类操作基本无效。
运行前务必手动保存文件
Notepad++ 不会自动保存再运行。你改了 10 行代码,但没按 Ctrl+S,点 F6 运行的仍是磁盘上旧版本。这个行为截至 2026 年 6 月仍无配置项可关闭,属于编辑器底层设计逻辑。
容易被忽略的是:哪怕你设置了自动备份、启用了“修改后提示保存”,只要没真正落盘,ruby 就读不到最新内容。建议养成 Ctrl+S → F6 的固定节奏。











