需先安装node.js（含npm），再全局安装typescript（tsc -v验证），接着在项目中局部安装并初始化tsconfig.json，最后用vs code打开项目即可获得原生ts支持。
如果您希望在 macOS 系统上搭建 TypeScript 开发环境，但尚未安装 TypeScript 编译器或相关依赖，则可能是由于缺少 Node.js 运行时或未正确配置 npm 包管理器。以下是完成安装与基础配置的完整操作步骤：
一、安装 Node.js 和 npm
Node.js 是 TypeScript 的运行基础，其自带 npm（Node Package Manager），用于后续安装 TypeScript 及其他开发工具。必须先确保该环境可用。
1、访问 https://nodejs.org 官网，下载并安装标有 LTS（长期支持）版本 的 macOS 安装包（.pkg 格式）。
2、双击安装包，按提示完成安装流程，接受默认路径与设置。
3、打开终端（Terminal），依次执行以下两条命令验证安装结果：
node -v
npm -v
4、若均输出类似 v20.13.1 和 10.5.2 的版本号，则表示 Node.js 与 npm 已就绪。
二、全局安装 TypeScript 编译器
全局安装可使 tsc 命令在任意目录下直接调用，适用于快速编译单文件或学习阶段使用。
1、在终端中执行以下命令：
npm install -g typescript
2、安装过程可能需要几秒至数十秒，请勿中断；若出现权限错误，不要使用 sudo，应优先检查 npm 全局路径权限或改用 nvm 管理 Node 版本。
3、安装完成后，运行以下命令验证：
tsc -v
4、成功时将显示类似 Version 5.4.5 的输出，确认 TypeScript 编译器已就位。
三、项目级局部安装 TypeScript
为保障团队协作与项目可复现性，推荐在每个项目中单独安装 TypeScript 作为开发依赖，避免全局版本冲突。
1、在终端中创建新项目目录并进入：
mkdir my-ts-app && cd my-ts-app
一款AI工具，主要用于Monitor and clean up invalid Codex authentication files in CPA. Check quota status, disable files returning 401 errors, and perform dual verification before deletion.，适合需要提升相关任务效率的用户。
2、初始化 npm 项目（生成 package.json）：
npm init -y
3、执行局部安装命令：
npm install typescript --save-dev
4、安装完成后，package.json 中 devDependencies 字段将包含 "typescript"，且 node_modules/.bin/tsc 可被 scripts 调用。
四、初始化 TypeScript 配置文件
tsconfig.json 定义了编译选项、源码路径、输出行为等核心规则，是项目级 TypeScript 行为控制中心。
1、确保已在项目根目录下（即含 node_modules 的目录）。
2、运行以下命令生成默认配置文件：
npx tsc --init
3、执行后将在当前目录创建 tsconfig.json 文件，内容包含注释说明的标准选项。
4、如需启用严格类型检查，可手动编辑该文件，将 "strict": false 改为 "strict": true。
五、配置 VS Code 编辑器支持
VS Code 原生集成 TypeScript 语言服务，无需额外插件即可获得语法高亮、智能提示与错误实时标记。
1、从 https://code.visualstudio.com 下载并安装最新版 VS Code for macOS。
2、启动 VS Code，通过菜单栏 File → Open Folder 打开前述创建的项目目录（如 my-ts-app）。
3、新建文件，命名为 hello.ts，输入以下代码：
console.log("Hello, TypeScript!");
4、保存文件后，VS Code 左下角状态栏将显示 TypeScript 版本号，且无红色波浪线报错，表明语言服务已激活。
