lit组件语法高亮异常和html模板报红，是因lit-plugin默认全局启用导致误判；应禁用自动启用、正确配置files.associations，并仅在lit文件中手动启用。
VSCode 里 Lit 组件没语法高亮、html 模板报红？先关掉 lit-plugin 的自动启用
Lit 官方推荐的 lit-plugin 默认会在打开任何含 html 字符串的文件时激活，结果是：你在写 React 或普通 JS 时，它强行校验模板语法，报一堆 Expected expression 或 Invalid lit-html template 错误。这不是你代码错了，是插件“管太宽”。
实操建议：
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜lit-plugin - 找到
lit-plugin: Enabled，**取消勾选**（别信默认值） - 再搜
files.associations，加一条："*.ts": "typescript"和"*.js": "javascript"—— 避免它把.ts文件误判成 HTML - 重启窗口后，只在明确是 Lit 组件的文件（比如含
html`或css`）里手动触发：按Cmd+Shift+P→ 输入lit-plugin: Enable in this workspace
为什么 html` 里的属性补全失效？检查 tsconfig.json 是否启用了 resolveJsonModule 和 jsx
lit-plugin 依赖 TypeScript 语言服务提供属性提示（比如 @click=${...} 或 .value=${...}）。但它对 TS 配置很敏感：如果项目用的是纯 JS，或 tsconfig.json 里 compilerOptions 缺了关键项，补全就直接哑火。
常见错误现象：光标停在 html`<input .value="${</code"> 后，没参数提示；或者 <code>classMap、ifDefined 等指令完全不识别。
实操建议：
- 确保
tsconfig.json中有："resolveJsonModule": true（Lit 的类型声明依赖 JSON 模块解析） - 如果用 TS 写组件，
"jsx": "preserve"必须存在（否则 TS 不会把html`当作 JSX-like 结构处理） - JS 项目也得配
jsconfig.json，且要包含"checkJs": true和"allowJs": true，否则插件拿不到类型上下文 - 改完配置后，务必执行
Restart TS Server（命令面板搜这个）
VSCode 报 Cannot find module 'lit'？别全局装，就在项目里装 lit 和 @types/lit
很多人用 npm install -g lit 或只装 lit 但漏掉类型包，导致 VSCode 的 TS 语言服务找不到定义，所有 html、css、nothing 都标红，连基础 API 都没提示。
使用场景：新建一个空文件夹，npm init -y 后直接开写 Lit 组件，还没装依赖就打开 VSCode —— 这是最容易踩坑的起点。
实操建议：
- 进项目根目录，运行：
npm install lit @types/lit（注意：Lit v3+ 已内置类型，但 VSCode 仍需@types/lit才能稳定工作） - 确认
node_modules/lit存在，且package.json里"lit"版本 ≥3.0.0 - 删掉
node_modules和package-lock.json重装一次，比反复重启 VSCode 更有效 - 如果用 pnpm，记得加
--save-dev并确认.pnpmfile.cjs没屏蔽类型包链接
调试 Lit 组件时断点不生效？关掉 sourceMap 的 inlineSources 选项
VSCode 调试器在 Lit 模板中打的断点（比如 html`<div> { debugger; }}></div>`）经常跳过，不是代码问题，而是 sourcemap 生成方式和 Lit 的模板编译机制冲突。
性能影响：开启 inlineSources: true 会让打包体积变大，且 VSCode 调试器无法准确定位到原始模板行号。
实操建议：
- 检查
tsconfig.json的compilerOptions，确保："sourceMap": true，但"inlineSources": false - 如果是 Vite 项目，在
vite.config.ts中确认build.sourcemap设为'inline'或true，但不要设'hidden' - 调试前清空浏览器缓存 + VSCode 的
.vscode/.sourcemap-cache目录（如有） - 断点优先打在事件回调函数内部，而不是模板字符串里 —— 前者更可靠
Lit 的模板是运行时编译的，VSCode 的静态分析能力天然受限。最稳的方式，是把逻辑抽到独立函数里调试，而不是指望在 html` 字符串里单步执行。
