tsc -v可快速验证typescript编译器是否安装并显示准确版本号;若提示“command not found”,需检查npm全局bin路径是否加入path,或改用npx tsc --version获取项目本地版本。

在Mac终端中快速确认TypeScript编译器是否已安装并获取其准确版本号,是排查类型报错、验证环境配置的第一步。若直接运行tsc提示“command not found”,说明全局未安装或PATH未生效,不能跳过验证直接假设已就绪。
用tsc -v命令查看版本
打开Mac终端(Terminal),输入以下命令并回车:
tsc -v
如果已正确安装,终端将立即输出类似Version 5.2.2的响应;若显示command not found: tsc,说明TypeScript编译器尚未全局安装,或安装后未被系统识别——此时需检查npm全局bin路径是否加入Shell配置(如~/.zshrc)。
若tsc命令不可用:先确认npm全局安装状态
执行以下命令检查npm全局安装目录是否在当前shell的PATH中:
echo $PATH | grep -o "/usr/local/bin\|/opt/homebrew/bin\|$(npm config get prefix)/bin"
若无任何输出,说明npm全局bin路径未加载。常见于M1/M2 Mac使用zsh但未在~/.zshrc中添加export PATH="$(npm config get prefix)/bin:$PATH"。此时即使运行了sudo npm install -g typescript,tsc也无法调用。
方法一:临时修复(仅当前终端生效)
运行export PATH="$(npm config get prefix)/bin:$PATH",再试tsc -v。
方法二:永久修复
将上述export语句追加到~/.zshrc,然后运行source ~/.zshrc重载配置。
验证是否为项目本地版本(非全局)
进入你的TypeScript项目根目录,确保该目录下存在node_modules/typescript:
ls node_modules/typescript/package.json | head -n1
若存在,说明项目锁定了局部TS版本。此时应优先使用项目内版本,而非全局版本——因为VS Code等编辑器默认读取工作区版本,全局版本可能引发语法兼容性错误。
查看项目内TS版本最可靠的方式是:
npx tsc --version
【npx会自动优先查找项目node_modules下的tsc】,结果与VS Code状态栏显示一致,这才是真实影响你开发体验的版本。











