VSCode报TS语法错误大概率是TypeScript版本不一致所致，应首选“TypeScript: Select TypeScript Version”并选“Use Workspace Version”，确保编辑器使用项目本地ts版本，再重启TS Server以同步语法支持。
VSCode 里代码明明能跑通，却一直报语法错误（比如 const 提示“Unexpected token”，?? 报红，装饰器标红），大概率不是代码写错了，而是编辑器用的 TypeScript 或 JavaScript 语言服务版本太旧，不认新语法。
为什么 TypeScript: Select TypeScript Version 是第一排查动作
VSCode 自带一个 TypeScript 语言服务，但它版本固定（比如当前内置可能是 4.9.x），而你的项目可能依赖 typescript@5.4.5。两者不一致时，编辑器“看”不到你启用的新语法（如 using 声明、extends unknown、模块导出语法变更），就会误报错。
- 状态栏右下角点击 TypeScript 版本号，会弹出当前使用的是
Bundled还是Workspace - 执行
TypeScript: Select TypeScript Version命令后，必须选Use Workspace Version，而不是“Use VS Code’s Version” - 如果选项里没有
Workspace，说明node_modules/typescript不存在——得先npm install typescript@latest --save-dev - 装完别忘了重启 TS Server：
TypeScript: Restart TS Server，否则改动不生效
tsconfig.json 里这些配置会放大版本差异
就算用了工作区版本，tsconfig.json 的 compilerOptions 如果和 TS 版本不兼容，照样报错。常见踩坑点：
Galileo TypeScript sdk
下载
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
-
"target": "ES2022"在 TS 4.7 以下不支持，会把Array.prototype.at()标红 -
"useDefineForClassFields": true是 TS 4.3+ 引入的，老版本直接报错而非警告 -
"module": "nodenext"或"moduleResolution": "bundler"只在 TS 5.0+ 有效，选了就必升版本 - 漏掉
"typeRoots"或"types"会导致@types/node等类型不加载，报Cannot find name 'require'
Python 和 JS/TS 切换逻辑完全不同，别混用
有人想用 Python 那套思路去切 TS 版本：查路径、手动指定可执行文件——这行不通。TypeScript 不是解释器，它是语言服务（Language Service），靠 VSCode 后台进程加载 lib/tsserver.js，不是调 tsc 命令。
- 不要试图在
settings.json里写typescript.tsdk指向全局安装路径（如/usr/local/lib/node_modules/typescript/lib），那会绕过项目隔离，引发团队协作问题 - 正确路径只该是相对路径：
"typescript.tsdk": "./node_modules/typescript/lib" - 加
"typescript.enablePromptUseWorkspaceTsdk": true是为了防止下次打开项目时又自动切回内置版本 - 如果你用 pnpm/yarn，确保
node_modules/typescript确实存在——某些 monorepo 配置下它可能被 hoist 到根目录，导致工作区找不到
真正容易被忽略的点是：TS 版本切换只影响编辑器内的诊断和提示，不影响实际构建。哪怕你在 VSCode 里用了 TS 5.4，tsc 命令仍走 package.json 中定义的脚本或全局安装版本。二者必须对齐，否则会出现“编辑器不报错但构建失败”或“构建通过但编辑器满屏红线”的割裂现象。
