必须在项目根目录创建tsconfig.json才能启用typescript支持;vscode依赖该文件激活语言服务,否则.ts文件仅作普通文本处理,无语法高亮、类型检查或智能提示。

直接在资源管理器里右键新建 .ts 文件就行,但必须确保项目根目录有 tsconfig.json,否则 VSCode 不会识别为 TypeScript 项目,也不提供类型检查和智能提示。
为什么新建 .ts 文件后没语法高亮或报错提示?
VSCode 默认靠 tsconfig.json 文件激活 TypeScript 语言服务。没有它,编辑器只当普通文本处理:
- 新建空文件夹 → 右键“新建文件” → 命名为
app.ts→ 打开后只有纯文本样式,无类型提示 - 运行
tsc --init生成tsconfig.json后,立刻生效(无需重启 VSCode) - 如果已有
tsconfig.json但提示仍不工作,检查文件是否在当前打开的**工作区根目录**(不是子文件夹里)
tsconfig.json 最小可用配置长什么样?
只要存在且合法,哪怕只写两行也能启用基础 TS 支持:
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs"
}
}
注意:"include" 或 "files" 字段非必需;VSCode 的语言服务不依赖它们,但 tsc 编译时会用到。
新建 .ts 文件后立即报错“Cannot find name 'console'”怎么办?
这是典型环境缺失信号,说明 lib 配置没覆盖运行时 API:
- 在
tsconfig.json的compilerOptions中加一行:"lib": ["es2020", "dom"](Node 环境可去掉"dom") - 或者更简单:删掉整个
tsconfig.json,重新运行tsc --init,它默认包含合理lib - 不要手动创建空
tsconfig.json—— 没有默认值,字段全靠tsc --init注释模板兜底
真正容易被忽略的是:VSCode 的 TS 支持完全依赖工作区上下文,而不是单个文件后缀。一个 .ts 文件放在没 tsconfig.json 的文件夹里,和放在 node_modules 里一样,不会触发类型检查。











