Ren'Py语法高亮不生效需安装官方Ren'Py插件并设置文件关联；代码跳转依赖Python 3.8+环境；中文需保存为UTF-8 with BOM编码。
Ren'Py 语法高亮不生效？先确认是否装对了插件
Sublime Text 默认不识别 .rpy 文件，直接打开只会当纯文本或 Python 处理——结果是 label、scene、show 这些关键字没颜色，缩进混乱，跳转也失效。
必须手动安装 Ren'Py 官方维护的语法包：Ren'Py（注意大小写和撇号）。它不是第三方魔改版，也不是叫 renpy-syntax 或 visual-novel 的模糊命名包。
- 用 Package Control →
Install Package→ 搜索并安装Ren'Py - 安装后重启 Sublime（部分版本需重启才加载新语法）
- 打开任意
.rpy文件，右下角状态栏应显示Ren'Py，不是Python或Plain Text
文件关联失败？手动设置 syntax override
即使装了插件，新建文件或某些路径下的 .rpy 仍可能被识别为 Python——这是 Sublime 的文件扩展名映射未生效，常见于 Windows 或项目根目录有 .sublime-project 干扰时。
临时解决：菜单栏 View → Syntax → Open all with current extension as... → Ren'Py
一劳永逸：在用户设置里加强制映射：
{
"extensions":
[
"rpy"
],
"syntax": "Packages/Ren'Py/Ren'Py.sublime-syntax"
}
- 该配置存放在
Preferences → Settings – Syntax Specific中（不是全局 Settings） - 路径里的
Packages/Ren'Py/Ren'Py.sublime-syntax必须完全匹配，少一个单引号或大小写错误都会导致黑屏式崩溃（Sublime 不报错，只静默失效） - 如果插件安装后没有
Ren'Py.sublime-syntax文件，说明安装不完整，重装插件
代码补全和跳转为啥不工作？检查 Python 环境绑定
Ren'Py 插件的跳转（如 jump label_name → Ctrl+Click 跳转到对应 label label_name:）和自动补全依赖 Sublime 的 Python 解析能力，但 Ren'Py 脚本不是标准 Python——它混用了自定义语句和 Python 表达式。
- 确保 Sublime 使用的是 Python 3.8+（Ren'Py 7.4+ 编译器要求），可通过
Tools → Developer → Show Console输入import sys; print(sys.version)验证 - 禁用所有干扰插件：特别是
AutoFileName、SublimeCodeIntel，它们会劫持.rpy的解析流程 - 补全触发词仅限于 Ren'Py 关键字（
if、menu、$后的 Python 变量不补全），别指望它像 IDE 那样推导Character("maya")的方法
中文字符乱码或保存出错？编码必须设为 UTF-8 with BOM
Ren'Py 引擎强制要求 .rpy 文件以 UTF-8 with BOM 编码保存，否则运行时报 SyntaxError: Non-UTF-8 code starting with '\xe4'，尤其在含中文对话时。
- 菜单栏
File → Save with Encoding → UTF-8 with BOM - 避免用系统记事本另存为 UTF-8（它默认无 BOM），也别依赖插件自动转换（如
ConvertToUTF8不支持 BOM 写入） - 可批量修复：用
Find → Find in Files搜^（行首），勾选Regular Expression，替换为\uFEFF$0，再统一保存为 UTF-8 with BOM
BOM 是隐形字节，看不见但 Ren'Py 编译器认得；漏掉它，脚本就卡在第一行中文上，连错误位置都报不准。
