- 前言
- 【Unity 实用工具篇】 | FastScriptReload实现 Unity 热重载
- 一、Unity热重载：FastScriptReload
- 1.1 介绍
- 1.2 效果展示
- 1.3 使用说明及下载
- 二、 插件导入并配置
- 2.1 安装
- 2.2 Play模式下启用热重载配置
- 2.2 Editor模式下启用热重载配置
- 三、快速使用
- 3.1 Play模式下使用热重载
- 3.2 编辑器模式下使用热重载
- 总结
前言
- 在实际开发中，最常见的痛点就是在调试复杂交互逻辑时需要反复重启游戏，每次重启都可能花费数分钟时间。
- 而使用这个工具后，可以在游戏运行过程中直接修改代码，修改会立即生效，无需任何等待。
- 只需要导入该插件
FastScriptReload，进行几个简单的配置步骤，就可以直接在项目中使用，方便快捷。
【Unity 实用工具篇】 | FastScriptReload实现 Unity 热重载
一、Unity热重载：FastScriptReload
1.1 介绍
FastScriptReload是一款专为Unity引擎设计的动态C#脚本热重载插件。它的核心目标是通过允许开发者在不中断游戏运行或编辑器工作流的情况下，即时应用修改的C#代码，从而极大限度地提升开发迭代速度，打破传统“修改-编译-重启”的循环瓶颈。
✨ 主要功能特点
- 双模式热重载：同时支持播放模式和编辑器模式。前者用于实时调试游戏逻辑，后者用于避免在编辑场景、资源或开发编辑器工具时，因微小代码改动而触发耗时的完整域重载。
- 状态保持：热重载过程中，游戏对象、组件实例以及其当前的字段值（如血量、位置、状态机状态）都会被最大程度地保留，使得调试可以基于现有情境继续。
- 广泛的代码修改支持：支持对现有方法的逻辑、返回值、局部变量进行修改；支持修改字段的默认值；支持添加新的私有方法、属性和事件。
- 可定制的重载生命周期：开发者可以在脚本中定义特殊的回调方法（如 OnScriptHotReload）。当该脚本热重载完成后，此方法会被自动调用，用于执行必要的状态重置或初始化操作。
- 与调试器兼容：热重载后的代码依然支持使用Visual Studio或Rider等IDE进行断点调试，保证了调试体验的完整性。
🎯 典型应用场景
| 场景 | 典型修改内容 | 节省的关键时间 |
|---|---|---|
| 数值平衡 | 速度、伤害、血量、生成率等数值变量 | 免去停止游戏→修改→重新运行→触发同样情境的循环。 |
| UI/视觉调试 | UI控件属性、动画参数、颜色、布局逻辑 | 免去为看一个颜色或位置变化而反复运行游戏。 |
| 逻辑/AI调试 | 条件判断、算法参数、行为树节点权重 | 在保持游戏运行和当前状态的前提下，直接观察逻辑变更结果。 |
| 复杂问题诊断 | 复杂问题高频诊断 | 在复现一个复杂Bug时，可以逐步修改、添加日志或调整判断条件，并立即观察行为变化，从而快速定位问题根源。 |
| 编辑器工具开发 | 工具界面、自定义Inspector、资源处理逻辑 | 免去每次修改工具代码都要关闭工具窗口、重启Unity的巨大开销。 |
1.2 效果展示
| 类型 | 效果 |
|---|---|
| Play模式热重载 | |
| 编辑器模式热重载 |
1.3 使用说明及下载
- 官方文档地址：fast-script-reload
- Unity商店地址：https://assetstore.unity.com/packages/tools/utilities/fast-script-reload-239351
- GitHub地址： https://github.com/handzlikchris/FastScriptReload
- CSDN下载地址：FastScriptReload
- 白嫖地址：VX搜我博客名字，回复【素材资源】
二、 插件导入并配置
2.1 安装
fast-script-reload插件安装有两种方式：
第一种：在Unity中通过Package Manager安装
Window -> Package Manager -> + -> Add package from Git URL
https://github.com/handzlikchris/FastScriptReload.git?path=Assets
第二种：通过GitHub或其他渠道下载fast-script-reload
将下载的插件复制到自己Unity项目Assets目录中。
2.2 Play模式下启用热重载配置
正常情况下，Unity中的脚本变化之后，Unity会进行全盘加载，热重载需要禁用这个功能。
第一步：设置Unity自动刷新类型：Edit -> Preferences -> Asset Pipeline -> Auto Refresh -> Enabled Outside of Playmode
只进行这一步操作之后，在Unity的Play模式下实现热重载功能了。
第二步：设置 Script Changes While Playing，将其设置为Recompile After Finished Playing。Edit -> Preferences -> General -> Script Changes While Playing -> Recompile After Finished Playing
此处设置后，在Play模式结束后会重新编译最新代码。若此处没有设置，那我们在Play运行时修改的脚本代码，在下次运行时不会变成最新代码。
2.2 Editor模式下启用热重载配置
第一步：设置Unity自动刷新类型：Edit -> Preferences -> Asset Pipeline -> Auto Refresh > Disable
这样不论Unity是否在Play运行模式下，在修改脚本后Unity都不会自动刷新。
第二步：打开插件面板，在Unity编辑器中，通过Window -> Fast Script Reload -> Start Screen打开主控制面板。
启用编辑器模式热重载：在控制面板中找到并勾选Enable auto Hot-Reload for changed files（确保其开启），以及类似Enable hot-reload outside of play mode的选项。
下面的Trigger full domain reload after N hot-reloads(when not in play mode)可以设置非Play模式下经过多少次热重载之后触发整个域的刷新。
值得注意的是，编辑器模式打开热重载之后，脚本代码不会立即刷新，若需要立即刷新可以按Ctrl + R重新刷新所有代码。
提示：
若编辑器内模式下热重载功能不生效，可能与Unity版本或插件版本有关。
建议重新看下上面的配置是否设置正确，或尝试更新版本再尝试。
三、快速使用
3.1 Play模式下使用热重载
通过上面的配置之后，在Unity的Play运行模式下，也可以直接修改Script代码，然后立即查看修改代码后的效果。
3.2 编辑器模式下使用热重载
通过配置之后，在编辑器模式下修改脚本不会立即触发刷新。可通过手动Ctrl + R执行刷新，避免每次修改一点东西就触发数秒的时间用于刷新。
总结
- 作为开发工具，FastScriptReload不会对应用性能产生显著影响。主要开销是重新编译代码的额外内存使用，只有在同一应用会话中进行数百次更改时才会明显。
- FastScriptReload是开发工具，不建议在生产构建中发布使用，在Build的时候可以移除掉以免影响实际应用。
- 除了本文介绍的关键功能外，还有很多参数可以配置，这点可以通过官方文档查阅，感兴趣的小伙伴也可深入研究。
- FastScriptReload简单易用，使用后可以极大提高开发效率，推荐大家使用。
🎬 博客主页：https://xiaoy.blog.csdn.net
🎥 本文由呆呆敲代码的小Y原创 🙉
🎄 学习专栏推荐：Unity系统学习专栏
🌲 游戏制作专栏推荐：游戏制作
🌲Unity实战100例专栏推荐：Unity 实战100例 教程
🏅 欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！
📆 未来很长，值得我们全力奔赴更美好的生活✨
------------------❤️分割线❤️-------------------------
资料白嫖，技术互助
| 学习路线指引（点击解锁） | 知识定位 | 人群定位 |
|---|---|---|
| 🧡 Unity系统学习专栏 | 入门级 | 本专栏从Unity入门开始学习，快速达到Unity的入门水平 |
| 💛 Unity实战类项目 | 进阶级 | 计划制作Unity的 100个实战案例！助你进入Unity世界，争取做最全的Unity原创博客大全。 |
| ❤️ 游戏制作专栏 | 难度偏高 | 分享学习一些Unity成品的游戏Demo和其他语言的小游戏！ |
| 💚 游戏爱好者万人社区 | 互助/吹水 | 数万人游戏爱好者社区，聊天互助，白嫖奖品 |
| 💙 Unity100个实用技能 | Unity查漏补缺 | 针对一些Unity中经常用到的一些小知识和技能进行学习介绍，核心目的就是让我们能够快速学习Unity的知识以达到查漏补缺 |
