需先确认node -v和npm -v正常输出版本，再执行npm install -g typescript且tsc -v返回4.x/5.x；layaair项目必须用自定义tsconfig.json配置target、module、typeroots等字段，而非vscode默认任务。
确认Node.js和TypeScript全局安装是否到位
VSCode本身不自带编译能力，LayaAir项目的TS编译依赖本地 tsc 命令。如果执行 tsc -v 报“command not found”，说明TypeScript编译器没装好，不是VSCode配置问题。
必须确保：
-
node -v和npm -v都能正常输出版本（LayaAir 2.x 推荐 Node.js 10.20.1～16.x，太新如 v20+ 可能触发layaair2-cmd兼容报错） -
npm install -g typescript成功，且tsc -v返回 4.x 或 5.x 版本（避免用 3.x 以下，缺少moduleResolution: node16等关键选项） - 若安装卡住或报 EACCES，别反复重试，先运行
npm cache clean --force再重装
必须用 tsconfig.json 而非 VSCode 默认编译任务
LayaAir项目有自己的一套模块路径和声明文件结构（比如 laya.d.ts 在 bin/libs/ 下），直接用 VSCode 自动生成的 tasks.json 调 tsc 会找不到类型定义，报一堆 Cannot find name 'Laya' 错误。
正确做法是手动生成符合 LayaAir 规范的配置：
- 在项目根目录运行
tsc --init创建基础tsconfig.json - 手动修改关键字段：
"target": "es5"（LayaAir WebGL 运行时只兼容到 ES5）"module": "commonjs"（LayaAir 构建链不支持 ESModule 输出）"typeRoots": ["./bin/libs", "./node_modules/@types"]（显式告诉编译器去哪里找Laya类型）"lib": ["es5", "dom"]（不能加es2015及以上，否则生成代码在低端浏览器崩溃） - 删掉
"outDir"和"rootDir"的注释，并设为"outDir": "./bin/js"、"rootDir": "./src"，和 LayaAir IDE 默认输出对齐
layaair2-cmd 是构建环节必需，但和 TS 编译无关
很多人混淆两个动作：TS 编译（tsc）是把 .ts 变成 .js；LayaAir 构建（layaair2-cmd build）是把 .js + 资源 + 引擎打包成可运行的 HTML。
所以：
-
npm install -g layaair2-cmd是必须的，但仅用于最终构建和发布，不影响你在 VSCode 里写代码、保存即编译 - 不要在
tasks.json里配layaair2-cmd当编译命令——它不处理 TS，只处理已产出的 JS - 如果你改了 UI 文件（
.ls）或动画（.ani），必须回到 LayaAir IDE 里点「发布」，VSCode 无法替代这部分工作
VSCode 插件只需开基础功能，关掉干扰项
LayaAir 的类声明（如 Laya.Sprite）靠的是 bin/libs/laya.d.ts，不是靠插件推断。装太多 TS 相关插件反而容易冲突。
建议只启用：
-
ESLint（配好eslint-config-laya规则后可查Laya.stage.addChild忘加new这类低级错误） -
Prettier（统一格式，但关闭其 TS 自动修复，避免把Laya.Handler.create(this, this.onLoaded)错误转成箭头函数） - 禁用
TSLint（已废弃）、TypeScript Hero（会强行补全非 LayaAir 标准的签名）
真正影响编码体验的，是 tsconfig.json 里 "typeRoots" 和 "lib" 是否写对——写错一个字母，VSCode 就不会提示 Laya.Scene 的任何方法。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
