Sublime Text 中 Ctrl+B 运行 Love2D 失败主因是未配置 Build System 或 love 未入 PATH；print 不显示因输出被重定向；修改代码需手动重建而非热重载；中文乱码或路径错误源于编码非 UTF-8 无 BOM 或路径分隔符非正斜杠。
Ctrl+B 运行失败：常见错误是没配 Build System 或路径不对
Sublime Text 默认不识别 love 命令，直接按 Ctrl+B 会报 “No build system” 或 “command not found”。这不是插件问题，而是构建逻辑根本没定义。
实操建议：
- 确认
love已加入系统 PATH（Windows 检查是否能 cmd 中运行love --version；macOS/Linux 检查which love输出） - 在 Sublime 中新建 Build System（Tools → Build System → New Build System），粘贴以下内容并保存为
Love2D.sublime-build：
{
"cmd": ["love", "."],
"working_dir": "$file_path",
"selector": "source.lua",
"file_regex": "^.*:(\d+): (.*$)"
}
-
"working_dir": "$file_path"是关键——Love2D 必须从项目根目录启动，否则love.graphics.newImage("img.png")会找不到资源 - 保存后，用 Tools → Build System → Love2D 手动选中一次，之后在同一目录下打开
main.lua就能直接Ctrl+B
调试时 print 不显示：不是代码错，是输出被重定向了
Love2D 在 Windows/macOS 上默认不弹出终端窗口，print() 输出会静默丢弃，导致你以为逻辑没执行。
实操建议：
- Windows 用户可改用
love.exe（带控制台版本）：把构建命令改成["love.exe", "."]，或右键love.exe→ “以管理员身份运行” 后再拖项目进去 - macOS/Linux 用户可在终端手动运行
love .，天然带 stdout；若坚持用 Sublime，可加个 wrapper 脚本，比如love-debug.sh：
#!/bin/bash echo "=== Starting Love2D debug session ===" love . echo "=== Love2D exited ==="
- 然后在 Build System 中把
"cmd"改成["bash", "love-debug.sh"]，并确保脚本有执行权限（chmod +x love-debug.sh）
main.lua 修改后没生效：别信“自动热重载”，Love2D 不支持
Sublime 的保存动作不会触发 Love2D 重启。你改完代码按 Ctrl+S，但游戏窗口里还是旧逻辑——这不是缓存，是 Love2D 根本没重新加载。
实操建议：
- 每次修改后必须手动
Ctrl+B（或Cmd+B）重建，这是唯一可靠方式 - 不要依赖插件声称的“live reload”，Love2D 官方无此机制；第三方如
love-socket或自研 hook 都需额外集成，且不稳定 - 如果项目结构复杂（含
conf.lua、子模块），确保main.lua是唯一入口；Love2D 只认这个文件名，其他require的模块修改后仍需重启才能生效
中文乱码或资源路径报错：编码和斜杠方向必须严格匹配
Love2D 强制要求源文件为 UTF-8 无 BOM 编码，且所有路径分隔符必须是正斜杠 /，哪怕你在 Windows 上开发。
实操建议：
- 在 Sublime 中：用 File → Save with Encoding → UTF-8 重存
main.lua；检查右下角状态栏是否显示 “UTF-8” - 路径写法必须统一为
love.graphics.newImage("assets/player.png")，不能写"assets\player.png"或"assets/player.jpg"（扩展名也要对） - 如果用
io.open()读配置文件，也得确保该文件是 UTF-8 编码，否则io.read()可能返回空或乱码
Love2D 的调试本质是“重启驱动迭代”，没有后台进程、没有变量监视器、没有断点——它的轻量恰恰意味着你要主动管理每一次运行上下文。最容易忽略的是 working_dir 和编码这两处，它们不出错时不显眼，一出错就全盘卡死。
