gdscript在vscode中无高亮、无补全、跳转失败，主因是语言模式未切为gdscript、godot未生成缓存、可执行路径未正确配置；需手动切换右下角语言模式、用godot 4.x打开项目生成缓存、填入tools版godot路径并刷新缓存。
GDScript在VSCode里没高亮、没补全、跳转失败——不是插件装错了，是语言模式没切、Godot缓存没生成、可执行路径填错了这三处漏掉一个就全挂。
右下角语言模式必须手动切为GDScript
VSCode默认把.gd文件当纯文本处理。打开player.gd后全是白底黑字、func不着色、缩进消失，就是这个原因。
- 点击VSCode窗口右下角状态栏的当前语言名（比如
Plain Text或JSON） - 从下拉菜单选
GDScript；如果列表里没有，说明godot-tools插件没装或没重启 - 装完插件后必须完全退出VSCode再重开，否则语言服务器不加载
- 确保项目根目录下存在
project.godot，否则插件会自动降级为哑模式
Godot Tools插件必须配对tools版可执行路径
补全卡顿、$Player.后面不弹position或move_and_slide，大概率是LSP（语言服务器）根本没起来——它依赖你本地Godot tools版本启动。
- 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 - 路径必须指向
tools后缀的可执行文件，不能是server或headless版 - 在VSCode设置中搜
godotTools.editorPath.godot4填入该路径，保存后运行命令面板里的GDScript: Refresh Cache
Ctrl+Click跳转失败？先用Godot编辑器打开一次项目
VSCode里按住Ctrl点_ready()提示No definition found，不是插件问题，是Godot没生成符号缓存。
- 用Godot 4.x（非3.x）直接打开你的项目文件夹（双击
project.godot或从编辑器内Open Project） - 哪怕只打开再关闭，也会在
.godot/目录下生成gdscript_*_cache文件 - VSCode必须在包含
project.godot的根目录下打开整个文件夹，不能只打开res://子目录 - 如果已满足上述条件仍跳转失败，检查
launch.json里的pathMappings是否匹配实际路径大小写（Linux/macOS严格区分Scripts和scripts）
保存时格式化错乱？关Prettier，强制用GDTooling
保存后if condition:被改成if (condition) {、缩进变空格、注释被挤到行尾——这是Prettier或EditorConfig在抢GDScript的格式化权。
- 在VSCode设置中搜
files.associations，确认"*.gd"关联的是gdscript而非javascript - 禁用Prettier、ESLint等JS系格式化插件对
.gd文件的影响 - 设置默认格式化工具为
gdtooling.godot-tools - 启用
editor.formatOnSave，但仅限GDScript上下文生效
最常被忽略的一点：Godot 4.2+对res://路径解析更严格，脚本里别用OS.get_executable_path()拼路径替代res://，否则VSCode的跳转和补全会因路径不一致彻底失效。
