

信号（Signal）是Godot引擎中最强大、最重要的机制之一，它实现了观察者模式，让节点之间可以松耦合地通信。本教程将通过实际案例，带你全面掌握Godot中的信号使用方法。

<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=115737960125604&bvid=BV1tsqJBtEee&cid=34808792710&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" width="640" height="480"></iframe>

## 什么是信号？

信号是一种事件通知机制。当一个节点发生某些事情时（比如按钮被点击、分数改变、动画播放完成等），它可以发出一个信号，其他节点可以"监听"这个信号，并在信号发出时执行相应的代码。

**信号的核心优势：**
- **解耦**：节点之间不需要直接引用，降低代码耦合度
- **灵活**：一个信号可以被多个节点监听
- **清晰**：代码结构更清晰，易于维护

---

## 一、内置信号的使用

Godot的许多节点都内置了信号，比如`Button`节点就有`pressed`信号。

### 1.1 场景结构

我们的`main.tscn`场景包含：
- 一个`Button`节点（按钮）
- 一个`Label`节点（标签），绑定`label.gd`脚本

![signal](https://www.suiyan.cc/assets/images/2025/signal/01.png)

### 1.2 在编辑器中连接信号

![signal](https://www.suiyan.cc/assets/images/2025/signal/02.png)

选中button后，在节点面板中设置信号

这表示：当`Button`的`pressed`信号发出时，调用`Label`节点的`_on_button_pressed`方法。

### 1.3 编写响应函数

在`label.gd`中，我们定义了响应函数：

```gdscript
extends Label

func _on_button_pressed() -> void:
    # 这里就是按钮点后会执行代码的地方
    self.text = "按钮被点击啦！！！！！"
```

**运行效果：**
- 点击按钮
- `Button`发出`pressed`信号
- `Label`的`_on_button_pressed`函数被调用
- 标签文本更新为"按钮被点击啦！！！！！"

![signal](https://www.suiyan.cc/assets/images/2025/signal/03.png)
---

## 二、自定义信号

除了内置信号，我们还可以创建自己的信号，用于传递自定义事件。

### 2.1 声明自定义信号

在`score_manager.gd`中，我们声明了一个带参数的信号：

```gdscript
extends Node

# 声明一个带参数的自定义信号，参数类型是整数 (int)
signal score_updated(new_score: int)

var current_score = 0
```

### 2.2 发出信号

当分数改变时，我们发出信号并传递新的分数值：

```gdscript
func increase_score(points: int):
    current_score += points
    # 当分数改变时，发出信号，并附带新的分数值
    emit_signal("score_updated", current_score)
```

这里使用了`emit_signal()`函数，第一个参数是信号名称，后面是传递给信号的参数。

> **注意**：在Godot 4中，你也可以直接使用信号名称来发出信号：
> ```gdscript
> score_updated.emit(current_score)
> ```

### 2.3 连接自定义信号

在`score_label.gd`中，我们连接到这个信号：

```gdscript
extends Label
@onready var score_manager: Node2D = $".." #连接到场景中的根节点ScoreManager

func _ready():
    # 在 _ready 函数中连接信号
    # 当 score_manager 发出 score_updated 信号时，执行 _on_score_manager_score_updated
    score_manager.score_updated.connect(_on_score_manager_score_updated)

# 这是我们响应信号的函数
func _on_score_manager_score_updated(new_score: int):
    # 更新 Label 的文本，显示新的分数
    self.text = "Score: " + str(new_score)
```

**关键点解析：**
- `@onready`：延迟初始化，确保节点树已经构建完成
- `connect()`：连接信号的方法
- 响应函数的参数必须与信号声明的参数一致

### 2.4 测试信号

在`score_manager.gd`的`_ready`函数中，我们测试信号：

```gdscript
func _ready() -> void:
    increase_score(10) # ScoreLabel 显示 Score: 10
    await get_tree().create_timer(2.0).timeout  # 等待2秒
    increase_score(5)  # ScoreLabel 显示 Score: 15
    await get_tree().create_timer(2.0).timeout  # 等待2秒
    increase_score(5)  # ScoreLabel 显示 Score: 20
```

**运行效果：**
- 场景加载后，分数立即变为10
- 等待2秒后，分数变为15
- 再等待2秒后，分数变为20

---

## 三、信号的两种连接方式

### 3.1 在编辑器中连接（可视化方式）

**步骤：**
1. 选择要发出信号的节点（如Button）
2. 在右侧"节点"面板中，找到"信号"选项卡
3. 双击要连接的信号（如pressed）
4. 选择接收信号的节点和方法
5. Godot会自动生成响应函数的框架代码

**优点：**
- 可视化操作，直观易懂
- 不需要写连接代码
- 适合简单的信号连接

### 3.2 在代码中连接（编程方式）

```gdscript
score_manager.score_updated.connect(_on_score_manager_score_updated)
```

**优点：**
- 更灵活，可以在运行时动态连接
- 可以传递额外的参数
- 适合复杂的信号连接

---

## 四、信号的高级用法

### 4.1 断开信号连接

如果不再需要监听某个信号，可以断开连接：

```gdscript
score_manager.score_updated.disconnect(_on_score_manager_score_updated)
```

### 4.2 一次性信号

使用`call_deferred`可以让信号只触发一次：

```gdscript
button.pressed.connect(_on_button_pressed, CONNECT_ONE_SHOT)
```

### 4.3 信号带多个参数

信号可以传递多个参数：

```gdscript
signal player_died(player_name: String, score: int, cause: String)

emit_signal("player_died", "Player1", 100, "Enemy")
```

### 4.4 检查信号是否已连接

```gdscript
if score_manager.score_updated.is_connected(_on_score_manager_score_updated):
    print("信号已连接")
```

---

## 五、最佳实践

### 5.1 命名规范

- 信号名称使用动词形式：`score_updated`、`player_died`、`game_over`
- 响应函数命名：`_on_节点名_信号名`，如`_on_button_pressed`

### 5.2 什么时候使用信号？

**适合使用信号的场景：**
- UI交互（按钮点击、输入框变化）
- 游戏状态变化（分数更新、生命值改变）
- 动画事件（动画播放完成、帧事件）
- 碰撞检测（进入/退出碰撞区域）

**不适合使用信号的场景：**
- 需要返回值的操作
- 高频调用的每帧逻辑（使用`_process`或`_physics_process`）

### 5.3 性能考虑

信号连接本身开销很小，但要注意：
- 避免在`_process`中频繁连接/断开信号
- 大量信号监听者可能影响性能

---

## 六、总结

通过本教程，我们学习了：

1. **内置信号**：使用Godot预定义的信号（如Button的pressed）
2. **自定义信号**：创建和发出自己的信号
3. **信号连接**：在编辑器和代码中连接信号
4. **信号参数**：传递数据给信号监听者
5. **高级用法**：断开连接、一次性信号、多参数信号

**信号是Godot开发中的核心概念，掌握它将让你的代码更加模块化、可维护。**

---

## 项目文件说明

本教程项目包含以下文件：

- `main.tscn`：演示内置信号（Button pressed）
- `label.gd`：响应按钮点击信号
- `score_manager.tscn`：演示自定义信号
- `score_manager.gd`：定义和发出自定义信号
- `score_label.gd`：监听并响应自定义信号

---

**祝你在Godot开发之路上越走越远！** 🚀


信号（Signal）是Godot引擎中最强大、最重要的机制之一，它实现了观察者模式，让节点之间可以松耦合地通信。本教程将通过实际案例，带你全面掌握Godot中的信号使用方法。

Godot 4 信号（Signal）的使用入门

新的一年，新的展望，除了每年的总结，也应该对新的一年有所期望。去年留下哪些未完成的心愿？以及在新的一年里有哪些新的愿望？

对自己心灵的拷问或许就能更清晰的规划2026年的计划。

1. 去年有那些未完成的心愿和任务？
2. 你是否按着2025年的计划完成了所有的预期的目标？
3. 你有要感谢的人吗？
4. 你是否还记得你的初心？
5. 2025你做过的最有意义的一件事是什么？
6. 到目前为止，你认为自己的优势是什么？你的不足又有那些？

或许还有很多需要叩心自问的灵魂拷问，展开这些不愿想起来的问题，总觉得不是很舒服。


## 娱乐至死

去年一整年的博客更新很是稀松，感觉整个人很散漫很荒废，无论是读书还是学习新的编程技术方面，都没有太大的突破。新的一年里应该更加努力。感觉这几年都是糊里糊涂的过去了，一时为自己的荒废感到痛惜和悲哀吧。去年我曾写过一篇博客:[《放下抖音，重构我的2025》](https://www.suiyan.cc/blog/20250116130857),现在回头看去，我也就放下了抖音不到二个月吧，之后一直沉迷于抖音不能自拔。刚刚看了一下，手机的使用时间，抖音大约每天要刷2小时+。猛然间回忆起自己独立思考的时间真的很短，除了写代码构思游戏情节之外，大多的思维和思考方式受到抖音大数据影响很大，比如总给我推小米相关的负面新闻报道以及一些负面视频，但是小米真的有那么糟糕吗？回头想想，大数据使我短时间内失去了客观分析事物的能力。就算小米有很多负面的新闻，我觉得小米这么大的一个企业，这么多的产品，不可能一个闪光之处都没有吧？

这么说来，娱乐至死使我失去了独立思考的能力，我说的吗，最近总觉得看什么事都提不起来劲，而且，口头禅总说抖音有个视频怎么说的如何如何。


## 人笨就得多读书

还是得多看看书，哪怕是看看电影都比抖音刷视频强。这阵子订阅了几个年轻人的博客RSS，还是年轻人思维敏捷灵活，而且对生活对事物的观察细致，以至于写的博客观点都是很独到而且很有个性。向他们学习，这帮孩子使我想起我年轻的时候，虽然现在年事已高，但还不至于老的要死，所以，还要拼一下的。书，还是要多看，并且要边看边思考，不然人真的要废了。不光要看技术类的书籍还得看看其他文学和小说以及热门新书，重新洗礼一下秀逗的大脑吧。

总之，2026不应该再混沌下去了，应该合理的安排任务清单，定期的审视清单，并做出总结，扫去拖延这个重症顽疾，多看书，多写代码，多写博客总结当下。


新的一年，新的展望，除了每年的总结，也应该对新的一年有所期望。

写在2026的岁首



![Speed Insights](https://www.suiyan.cc/assets/images/2025/kanban-dark.avif)


如果你的项目托管在Vercel，那么 Web Analytics 与 Speed Insights 是Vercel提供的非常不错的网络分析与用户体验分析工具，值得在项目中安装部署。


## Vercel Web Analytics

安装包：

    npm i @vercel/analytics


Next.js项目中添加代码：

    import { Analytics } from '@vercel/analytics/next';
    
    export default function RootLayout({ children }) {
    return (
        <html lang="en">
        <head>
            <title>Next.js</title>
        </head>
        <body>
            {children}
            <Analytics />
        </body>
        </html>
    );
    }

保存项目，推送到github，这样你就有了一个非常简单的访问统计以及分析了，可以在vercel的控制面板中查看。


## Vercel Speed Insights

Speed Insights是用来观测用户真实的访问网站速度体验的，可以直观的看到用户连接网站的访问速度，依次为依据对页面进行优化，已达到最佳的访问速度。而且指标优秀的话，也容易背搜索引擎收录。

安装方法和上边的差不多：

    npm i @vercel/speed-insights

项目中插入代码：

    import { SpeedInsights } from '@vercel/speed-insights/next';
    
    export default function RootLayout({ children }) {
    return (
        <html lang="en">
        <head>
            <title>Next.js</title>
        </head>
        <body>
            {children}
            <SpeedInsights />
        </body>
        </html>
    );
    }

保存项目，推送到github，vercel重新构建项目后刷新页面就会看到访问速度的数据了。


## 总结

通过这这两个插件的数据可以分析站点的访问统计以及访问速度，站长可以根据数据对站点进行优化，使网站已达到最佳的访问状态。


如果你的项目托管在Vercel，那么 Web Analytics 与 Speed Insights 是Vercel提供的非常不错的网络分析与用户体验分析工具，值得在项目中安装部署。

写在2026的岁首

娱乐至死

人笨就得多读书

相关文章