必须使用hbenl.vscode-protobuf插件并手动配置绝对路径的protobuf.protocPath和多级-I的protobuf.protocArgs，否则import跳转、service导航和跨文件引用校验全部失效；其他插件不调用protoc，无法实现语义解析。
vscode-protobuf 必须手动指定 protobuf.protocPath，否则 import 跳转和 service 导航全部失效——这不是插件问题，是配置漏项。
Python/Java/Rust/Go 的语法高亮不是“开箱即用”
VS Code 默认只对 .js、.ts、.html、.json、.md 等少数后缀提供基础高亮；.py、.java、.rs、.go 文件若没装对应插件，一律识别为 Plain Text，连括号匹配都可能错乱。
- Python：装
Python（Microsoft 官方），它自带Pylance，不装就无类型提示、无跳转定义 - Java：必须装
Java Extension Pack，且系统需已安装 JDK 17+ 并正确设置JAVA_HOME，否则状态栏卡在Starting Java Language Server… - Rust：只认
Rust Analyzer，旧版Rust插件已停更，无法解析async fn或泛型 trait - Go：装
Go（Go Team 官方），它会自动拉取gopls，但若GOROOT或GOBIN配错，go.mod文件将无高亮
.proto 文件高亮必须用 hbenl 的插件
搜索 “protobuf” 时，只认准发布者 hbenl、名称为 Protocol Buffers 的插件（ID：hbenl.vscode-protobuf）。其他名字带 proto3 或 support 的插件，基本不调用 protoc，也不支持跨文件 import 校验。
-
protobuf.protocPath必须填绝对路径，例如 Windows："D:/dev_tools/protoc-24.4-win64/bin/protoc.exe"，不能用%PATH%或相对路径 - 路径中含空格或中文会导致静默失败；反斜杠
\不被识别，一律用正斜杠/ - 多
-I路径靠protobuf.protocArgs配置，如：["-I", "common/proto", "-I", "api/proto"]
Vue 单文件组件要高亮 <script setup></script> 得换 Volar
Vetur 已弃用，对 Vue 3 的 <script setup></script> 语法支持极差，CPU 占用高、补全延迟明显。必须卸载 Vetur，改用 Volar（Vue 官方推荐）。
- 装完
Volar后，需在工作区设置里禁用Vetur的语言模式，否则两者冲突，.vue文件仍按Plain Text渲染 - 全局关联
.vue到vue语言模式：在settings.json加"files.associations": { "*.vue": "vue" } - 若
template区域 HTML 标签无高亮，说明Volar未激活——确认是否打开的是文件夹（而非单个文件），插件仅在工作区模式下加载
自定义后缀绑定语言模式的通用方法
遇到 config.yaml 显示为 Plain Text、nginx.conf 没缩进高亮，本质是 VS Code 没把后缀映射到对应语言模式。
- 点击右下角当前语言标识（如
Plain Text），选Configure File Association for 'yaml'→YAML - 想一劳永逸？直接编辑
settings.json，加一行："files.associations": { "*.conf": "ini", "*.thrift": "thrift" } - 注意：部分语言（如
thrift）需先装对应插件，否则即使绑定了，也只高亮不校验
真正影响开发效率的从来不是“有没有高亮”，而是“高亮背后有没有语义能力”。比如 .proto 文件里红波浪线标出 file not found，靠的是 protoc AST 解析；.vue 里 ref() 变量能跳转定义，靠的是 Volar 对 setup 的编译时分析。这些都不是简单装个插件就能自动生效的。
