必须安装Ren'Py Language插件（LuqueDaniel发布），手动设置文件关联为Ren'Py语言模式，Python解释器路径须指向renpy.exe，调试需通过Ren'Py启动器集成VS Code，lint建议关闭以避免AI生成代码误报。
Ren'Py Language 插件必须装，但装完不等于能用
VS Code 默认不认识 .rpy 文件，光靠 Python 插件或通用语法高亮完全无效。必须安装 Ren'Py Language 扩展（作者 LuqueDaniel），否则连基础的 label start: 都不会高亮，更别提跳转定义或颜色预览。
常见错误现象：
- 装了“Python”插件后以为万事大吉，结果打开
script.rpy显示为纯文本 - 搜索“renpy vscode”误装了名字相近的第三方插件（如
Ren'Py Support），功能残缺且长期未更新 - 插件已启用，但右下角语言模式仍显示
Plain Text—— 这说明文件关联没生效
实操建议：
- 在扩展面板中精确搜索
Ren'Py Language，认准发布者LuqueDaniel和 2025 年后的更新时间 - 安装后手动点击右下角语言标识，选择
Ren'Py（不是 Python 或 Text） - 若项目里有自定义扩展名（如
scene.ai.rpy），需在settings.json中补全关联："files.associations": { "*.ai.rpy": "renpy" }
Python 解释器路径不能选系统 Python，得指向 renpy.exe
Ren'Py 自带 Python 运行时，和你本地装的 Python 3.11 或 Anaconda 完全不兼容。VS Code 的 Python 插件如果绑定了系统解释器，会导致 lint 报错、renpy 模块找不到、甚至调试时直接崩溃。
关键判断：只要你在 script.rpy 里写了 init python: 块，又看到红色波浪线标出 ImportError: No module named 'renpy'，基本就是解释器配错了。
实操建议：
- 不要用
Python: Select Interpreter命令从列表里随便选 —— Ren'Py 的renpy.exe不会出现在那里 - 手动编辑项目根目录下的
.vscode/settings.json，写死路径："python.defaultInterpreterPath": "D:/renpy/renpy-8.1.3-sdk/renpy.exe" - Windows 用户注意路径分隔符必须是正斜杠
/或双反斜杠\，单反斜杠会解析失败 - 路径中的版本号（如
8.1.3-sdk）必须和你实际安装的 Ren'Py 完全一致，改错一个数字就无法加载
调试脚本不能直接 F5，得靠 Ren'Py 启动器 + VS Code 编辑器集成
VS Code 的 Python 调试器（launch.json）对 Ren'Py 项目基本无效。Ren'Py 不是普通 Python 脚本，它依赖自己的启动流程、资源加载机制和热重载逻辑。硬套 Python 调试配置只会卡在入口、找不到 game/ 目录，或者报 AttributeError: module 'renpy' has no attribute 'main'。
真正能调试的方式，是让 Ren'Py 启动器（launcher）直接调起 VS Code 编辑当前脚本，并在出错时自动跳转到对应行。
实操建议：
- 在 Ren'Py 项目根目录下新建
VSCode.edit.py，内容需继承renpy.editor.Editor并实现open()方法，核心是调用code -g "${file}:${line}" - 在 Ren'Py 启动器的「Preferences」→「Text Editor」里，把编辑器路径设为该
VSCode.edit.py文件的绝对路径 - 确保系统 PATH 里有
code命令（Windows 下安装 VS Code 时勾选「Add to PATH」） - 出错时点击启动器里的报错信息，会自动打开 VS Code 并定位到
.rpy文件对应行 —— 这才是 Ren'Py 场景下的“调试”
AI 生成的 Ren'Py 代码容易触发 lint 误报，关掉严格检查更实用
AI 工具常输出不符合 Ren'Py 官方风格但语法合法的代码（比如用 if True == True: 替代 if True:，或在 init python: 块里写多层嵌套函数）。Ren'Py Language 插件默认开启的 lint 会把这些标成“冗余条件”或“未使用变量”，干扰开发节奏。
这不是代码有错，而是检查规则和 AI 输出习惯不匹配。强行改代码去迎合 lint，反而可能破坏逻辑或引入新 bug。
实操建议：
- 在项目级
settings.json中关闭 lint："renpy.lint.enable": false - 保留
"renpy.script.extensions": ["rpy"]，确保语法高亮和跳转不受影响 - 如果只希望对特定文件放宽检查，可用注释临时禁用：
# renpy-lint-disable-next-line unused-variable - 注意：关 lint 不等于放弃质量，关键逻辑仍需人工验证，尤其是涉及
jump、call和图像加载路径的部分
最易被忽略的一点：每次修改 VSCode.edit.py 或 settings.json 后，必须完全退出并重启 VS Code —— 简单重载窗口（Ctrl+R）不会刷新 Ren'Py 插件的运行时状态，旧配置依然生效。
