var inputField = GetNode<LineEdit>("ChatInput");
inputField.ReleaseFocus();
// 运行结果: ChatInput 失去焦点，光标消失，键盘输入不再影响它

var button = GetNode<Button>("MyButton");
button.ReleaseFocus();
// 运行结果: 按钮取消高亮，不再处于选中状态

GDScript

var input_field = $ChatInput as LineEdit
input_field.release_focus()
# 运行结果: ChatInput 失去焦点，光标消失，键盘输入不再影响它

var button = $MyButton as Button
button.release_focus()
# 运行结果: 按钮取消高亮，不再处于选中状态

实际场景：聊天输入框发送消息后自动失去焦点

using Godot;

public partial class ChatUI : Control
{
    private LineEdit _chatInput;
    private RichTextLabel _chatLog;

    public override void _Ready()
    {
        _chatInput = GetNode<LineEdit>("ChatInput");
        _chatLog = GetNode<RichTextLabel>("ChatLog");
    }

    public override void _Input(InputEvent evt)
    {
        // 按回车发送消息
        if (evt.IsActionPressed("ui_text_submit") && _chatInput.HasFocus())
        {
            string message = _chatInput.Text.Trim();
            if (!string.IsNullOrEmpty(message))
            {
                _chatLog.AppendText($"[你] {message}\n");
                // 运行结果: 聊天记录中显示发送的消息
            }

            _chatInput.Text = "";
            _chatInput.ReleaseFocus();
            // 运行结果: 发送消息后输入框清空并失去焦点，键盘恢复游戏控制
        }

        // 按 Tab 键重新聚焦到输入框
        if (evt.IsActionPressed("open_chat"))
        {
            _chatInput.GrabFocus();
        }
    }
}

GDScript

extends Control

@onready var _chat_input: LineEdit = $ChatInput
@onready var _chat_log: RichTextLabel = $ChatLog

func _input(evt):
    # 按回车发送消息
    if evt.is_action_pressed("ui_text_submit") and _chat_input.has_focus():
        var message = _chat_input.text.strip_edges()
        if message != "":
            _chat_log.append_text("[你] %s\n" % message)
            # 运行结果: 聊天记录中显示发送的消息

        _chat_input.text = ""
        _chat_input.release_focus()
        # 运行结果: 发送消息后输入框清空并失去焦点

    # 按 Tab 键重新聚焦到输入框
    if evt.is_action_pressed("open_chat"):
        _chat_input.grab_focus()

进阶用法：在游戏战斗时移除所有 UI 焦点

using Godot;

public partial class GameManager : Node
{
    private Control _gameHUD;
    private bool _isInCombat = false;

    public override void _Ready()
    {
        _gameHUD = GetNode<Control>("GameHUD");
    }

    public void EnterCombat()
    {
        _isInCombat = true;

        // 让当前拥有焦点的控件失去焦点
        var focusedOwner = GetViewport().GuiGetFocusOwner();
        focusedOwner?.ReleaseFocus();

        // 运行结果: 进入战斗后所有 UI 控件失去焦点，键盘输入不会被 UI 拦截
        GD.Print("进入战斗模式，UI 焦点已清除");
    }

    public void ExitCombat()
    {
        _isInCombat = false;

        // 战斗结束后让背包按钮重新获得焦点
        var inventoryButton = _gameHUD.GetNode<Button>("InventoryButton");
        inventoryButton.GrabFocus();

        // 运行结果: 战斗结束后背包按钮自动获得焦点
    }
}

GDScript

extends Node

@onready var _game_hud: Control = $GameHUD
var _is_in_combat: bool = false

func enter_combat():
    _is_in_combat = true

    # 让当前拥有焦点的控件失去焦点
    var focused_owner = get_viewport().gui_get_focus_owner()
    if focused_owner:
        focused_owner.release_focus()

    # 运行结果: 进入战斗后所有 UI 控件失去焦点
    print("进入战斗模式，UI 焦点已清除")

func exit_combat():
    _is_in_combat = false

    # 战斗结束后让背包按钮重新获得焦点
    var inventory_button = _game_hud.get_node("InventoryButton") as Button
    inventory_button.grab_focus()

    # 运行结果: 战斗结束后背包按钮自动获得焦点

注意事项

只在控件拥有焦点时有效：如果控件本来就没有焦点，调用 ReleaseFocus() 不会有任何效果，也不会报错。
通过 Viewport 查询当前焦点：可以用 GetViewport().GuiGetFocusOwner() 获取当前拥有焦点的控件，然后对它调用 ReleaseFocus()。
焦点释放后键盘事件恢复：控件失去焦点后，键盘输入不再被该控件拦截，_UnhandledInput 等方法可以正常接收到键盘事件。
与 GrabFocus() 配合使用：通常在让 A 失去焦点的同时会让 B 获得焦点。如果只是调用 ReleaseFocus() 而不指定新的焦点目标，界面上可能没有任何控件被选中。