Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

使用外部的文本编辑器

本页面讲述的是如何使用外部文本编辑器编写代码。

Godot 可以与 Sublime Text、Visual Studio Code 等外部文本编辑器一起使用。在编辑器中浏览相关设置: 编辑器 -> 编辑器设置 -> 文本编辑器 -> 外部

文本编辑器 > 编辑器设置的外部部分

编辑器设置中的 文本编辑器 > 外部 部分

有两个文本字段:可执行文件路径和执行参数(标志)。这些标志允许你将编辑器与 Godot 集成在一起,并向其传递要打开的文件路径和其他相关参数。Godot 将替换参数字符串中的以下占位符:

Exec 标志中的字段

被替换为

{project}

项目目录的绝对路径

{file}

文件的绝对路径

{col}

错误的列号

{line}

错误的行号

一些编辑器的 Exec 标志 示例:

编辑器

Exec 标志

Geany/Kate

{file} --line {line} --column {col}

Atom

{file}:{line}

JetBrains Rider

{project} --line {line} {file}

Visual Studio Code

{project} --goto {file}:{line}:{col}

Vim (gVim)

"+call cursor({line}, {col})" {file}

Emacs

emacs +{line}:{col} {file}

Sublime Text

{project} {file}:{line}:{column}

备注

对于 Windows 平台上的 Visual Studio Code,你需要指向 code.cmd 文件。

对于 Emacs,如果你使用的是服务器模式,那么调用的时候就可以用 emacsclient 代替 emacs

在调试器中使用外部编辑器

在调试器中使用外部编辑器由设置中的单独选项决定。更多细节详见 脚本编辑器调试工具及选项

官方编辑器插件

以下代码编辑器有官方插件:

LSP/DAP 支持

Godot supports the Language Server Protocol (LSP) for code completion and the Debug Adapter Protocol (DAP) for debugging. You can check the LSP client list and DAP client list to find if your editor supports them. If this is the case, you should be able to take advantage of these features without the need of a custom plugin.

To use these protocols, a Godot instance must be running on your current project. You should then configure your editor to communicate to the running adapter ports in Godot, which by default are 6005 for LSP, and 6006 for DAP. You can change these ports and other settings in the Editor Settings, under the Network > Language Server and Network > Debug Adapter sections respectively.

Below are some configuration steps for specific editors:

Visual Studio Code

你需要安装官方`Visual Studio Code 插件 <https://github.com/godotengine/godot-vscode-plugin>`_ 。

For LSP, follow these instructions to change the default LSP port. The connection status can be checked on the status bar:

../../_images/lsp_vscode_status.png

For DAP, specify the debugServer property in your launch.json file:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "GDScript Godot",
            "type": "godot",
            "request": "launch",
            "project": "${workspaceFolder}",
            "port": 6007,
            "debugServer": 6006,
        }
    ]
}

Emacs

请查看官方说明来配置 LSPDAP.