GDScript语法高亮和补全失效需依次检查：右下角切换语言模式为GDScript；安装官方godot-tools插件并重启；用Godot 4.x打开项目生成缓存；VSCode须打开含project.godot的根目录；配置godot.executablePath指向tools版可执行文件；禁用Prettier等第三方格式化，设默认格式化工具为gdtooling.godot-tools。
GDScript语法高亮和基础补全没反应？先确认插件和语言模式
VSCode默认不识别.gd文件，必须手动激活GDScript语言支持。常见现象是打开player.gd后全是白色文本、无缩进、func或extends不着色——这不是配置问题，是语言模式没切对。
- 点击右下角状态栏的
Plain Text（或当前语言名），选GDScript；如果列表里没有，说明插件未安装 - 安装官方插件：
godot-tools（由Godot官方维护，非GDScript等第三方旧版） - 安装后重启VSCode，再打开
.gd文件，状态栏应显示GDScript且自动启用语法高亮
Ctrl+Click跳转不到函数定义？检查项目是否在Godot编辑器中打开过
godot-tools插件的符号索引严重依赖Godot编辑器生成的缓存文件。没用Godot打开过项目，VSCode里Ctrl+Click任何func _ready()或自定义函数都会失败，提示“no definition found”。
- 必须先用Godot 4.x打开项目一次（哪怕只点开再关闭），它会在
.godot/目录下生成gdscript_*_cache相关文件 - VSCode需在项目根目录（含
project.godot）下打开整个文件夹，不能只打开res://子目录 - 若已满足上述条件仍无效，尝试在VSCode命令面板（
Ctrl+Shift+P）运行GDScript: Refresh Cache
代码补全只有基础关键字，没有节点方法或信号？别漏掉GDScript语言服务器路径
插件默认会尝试自动查找Godot可执行文件，但Windows/macOS/Linux路径差异大，常导致LSP（语言服务器）启动失败，表现为：能识别varfunc，但输入$Player.后无positionmove_and_slide等方法提示。
- 打开VSCode设置（
Ctrl+,），搜索godot.executablePath - 填入你本地Godot编辑器的完整路径：
- Windows：
C:\Program Files\Godot\godot.windows.tools.64.exe - macOS：
/Applications/Godot.app/Contents/MacOS/Godot - Linux：
/home/you/godot/godot.linux.tools.64
- Windows：
- 路径必须指向
tools版本（含编辑器功能），不能是导出用的headless或server版
保存时自动格式化乱套？关掉Prettier，用Godot原生格式化
很多用户装了Prettier或EditorConfig插件，结果保存.gd文件时被错误格式化：缩进变空格、if后多加空行、注释错位。GDScript格式化规则和JavaScript完全不同，必须交由Godot自身处理。
- 在VSCode设置中搜
files.associations，确认"*.gd": "gdscript"已存在 - 搜
editor.defaultFormatter，把gdscript语言的默认格式化工具设为gdtooling.godot-tools - 禁用所有针对
.gd的其他格式化扩展（尤其esbenp.prettier-vscode的prettier.enable要关，或在prettier.disableLanguages里加上gdscript）
Godot 4的GDScript语言服务器对项目结构敏感，路径错一级、缓存没刷新、甚至project.godot里config/version写错，都可能导致补全或跳转静默失效——这种问题不会报红，只会让你觉得“好像差不多，但总差点意思”。
