若VSCode中TypeScript无类型检查或智能提示，需依次安装全局TypeScript、配置tsconfig.json、切换至工作区TS版本、必要时添加jsconfig.json或JSDoc注释。
如果您在VSCode中编写TypeScript代码时未获得类型检查或智能提示，可能是由于工作区未正确初始化TypeScript支持或缺少必要配置。以下是实现基础TypeScript开发环境并启用智能提示的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装TypeScript全局包与VSCode插件
TypeScript语言服务依赖于本地或全局安装的tsc编译器，VSCode通过内置TypeScript SDK或用户指定路径加载该服务以提供语法分析与补全能力。
1、打开终端，执行命令安装TypeScript全局包：npm install -g typescript。
2、启动VSCode，在扩展市场搜索并安装官方扩展：TypeScript and JavaScript Language Features（该扩展已预装于较新版本，可跳过）。
3、验证安装：在终端中运行tsc --version，确认输出版本号不低于5.0。
二、初始化TypeScript项目配置
tsconfig.json是TypeScript项目的根配置文件，它定义编译选项、包含路径及类型检查规则，VSCode据此启用语义化提示与错误标记。
1、在项目根目录打开终端，执行命令生成默认配置：tsc --init。
2、打开生成的tsconfig.json文件，确保以下字段存在且值为true："allowJs": true、"checkJs": false（若含.js文件需设为true）、"composite": false。
3、添加路径映射提升模块导入提示：在compilerOptions中加入"baseUrl": "./src"与"paths": { "@/*": ["*"] }（需同步创建jsconfig.json或保持tsconfig.json生效）。
三、启用VSCode内建TypeScript服务器
VSCode默认使用内置TypeScript版本，但可能与项目依赖不一致；手动切换至工作区版本可确保提示逻辑与编译行为严格对齐。
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
1、在VSCode中按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），输入并选择：TypeScript: Select TypeScript Version。
2、在弹出菜单中选择Use Workspace Version（前提是node_modules中已安装typescript包）。
3、重启TS服务器：再次调用命令面板，执行TypeScript: Restart TS server。
四、配置jsconfig.json以支持混合JavaScript项目
当项目同时包含.ts与.js文件，且未使用完整TypeScript编译流程时，jsconfig.json可替代tsconfig.json触发基础类型推导与路径提示。
1、在项目根目录新建文件，命名为jsconfig.json。
2、写入最小有效配置：{"compilerOptions": {"allowSyntheticDefaultImports": true, "maxNodeModuleJsDepth": 2}}。
3、保存后，在任意.js文件中输入对象属性，观察是否出现基于JSDoc注释的参数提示（如/** @type {string} */）。
五、启用JSDoc驱动的类型提示
无需重写代码为.ts，仅通过标准JSDoc注释即可激活VSCode对JavaScript文件的强类型提示能力，适用于渐进式迁移场景。
1、在.js文件顶部添加注释：/** @typedef {import('./types').User} User */（引用外部.d.ts定义）。
2、对变量添加类型标注：/** @type {User} */ const user = {};。
3、在user.后触发自动补全，确认提示项包含User接口中定义的所有属性。
