Mac全局安装TypeScript后VS Code中tsc命令找不到的问题

可能的原因 #

• npm全局包路径未加入系统PATH：Mac上npm全局包的默认安装路径（比如/usr/local/bin或~/npm/bin）可能没被加入VS Code的环境变量PATH中。VS Code启动时继承的是用户登录shell的PATH配置，要是这个路径没在里面，自然找不到tsc命令。
• VS Code终端未加载shell配置：VS Code默认可能使用非交互式shell，这类shell不会自动加载.bashrc、.zshrc等文件里的PATH设置，导致全局包路径没被加载进来。
• 全局安装权限异常：执行npm install -g时如果权限不够，可能会把TypeScript装到用户目录下的某个非标准位置，而这个位置不在PATH里，VS Code自然找不到。
• VS Code终端环境缓存：VS Code的终端可能缓存了旧的环境变量，哪怕你后来配置了正确的PATH，没刷新的话还是会用旧的配置。

解决办法 #

1. 先确认npm全局包路径 #

执行npm list -g typescript，查看全局TypeScript的安装路径，对应的tsc可执行文件一般在该路径同级的bin目录下（比如/usr/local/bin/tsc）。
再执行echo $PATH，检查输出里有没有这个bin目录。如果没有，就需要把它加入系统PATH。

2. 配置系统PATH（必要时操作） #

• 如果你用zsh，编辑~/.zshrc文件，添加一行：export PATH="/usr/local/bin:$PATH"（把路径替换成你实际找到的npm全局bin目录）
• 如果你用bash，编辑~/.bashrc或~/.bash_profile，添加同样的内容。
• 保存文件后执行source ~/.zshrc（或对应的bash配置文件）刷新配置，然后重启VS Code。

3. 让VS Code使用系统交互式shell #

打开VS Code设置，搜索terminal.integrated.defaultProfile.osx，选择你日常用的shell（比如zsh或bash）。之后重启VS Code的终端，或者直接重启VS Code。

4. 修复全局安装权限问题 #

如果之前安装时有权限报错，推荐配置npm用用户目录安装全局包，避免用sudo：

1. 创建用户专属的npm全局目录：mkdir ~/.npm-global
2. 配置npm使用这个目录：npm config set prefix '~/.npm-global'
3. 把~/.npm-global/bin加入系统PATH（步骤同2）
4. 重新全局安装TypeScript：npm install -g typescript

5. 刷新VS Code终端环境 #

在VS Code的终端里执行source ~/.zshrc（或对应的配置文件），或者关闭终端窗口重新打开，也可以直接重启VS Code来刷新环境变量。

内容的提问来源于stack exchange，提问作者Eyre Connors