Visual Studio Code中TypeScript Azure Functions报错：'func'未被识别

1. 先确认Azure Functions Core Tools有没有安装 #

打开终端（CMD、PowerShell或VS Code内置终端均可），直接输入func --version，如果仍报相同错误，说明工具未安装或系统无法定位它。

选一种方式安装即可： #

• 通过npm安装：在终端执行命令 npm install -g azure-functions-core-tools@4 --unsafe-perm true（@4为当前稳定版本，需其他版本可修改数字）
• 通过系统包管理器安装：
  • Windows（使用Chocolatey）：执行 choco install azure-functions-core-tools
  • macOS（使用Homebrew）：执行 brew install azure-functions-core-tools
  • Linux：使用对应发行版的包管理器（如apt、yum）完成安装

2. 检查系统PATH是否包含func工具的路径 #

安装完成后仍报错，大概率是系统环境变量PATH未添加工具路径，导致系统无法找到func命令：

• Windows操作步骤：
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」列表中找到Path，查看是否包含类似C:\Users\<你的用户名>\AppData\Roaming\npm\node_modules\azure-functions-core-tools\bin的路径（npm全局安装的默认位置）
  3. 若未包含，手动添加该路径，随后关闭所有终端和VS Code并重新打开
• macOS/Linux操作步骤：
  1. 在终端执行echo $PATH，查看输出中是否包含/usr/local/bin（Homebrew安装的默认位置）或~/.npm-global/bin（npm全局安装位置）
  2. 若未包含，编辑~/.bashrc或~/.zshrc（根据你使用的shell选择），添加一行export PATH="$PATH:/usr/local/bin"（替换为实际安装路径），再执行source ~/.bashrc或source ~/.zshrc使配置生效，最后重启终端和VS Code

3. 重新加载VS Code窗口 #

配置完PATH后，打开VS Code按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Reload Window并回车，让VS Code重新读取系统环境变量。

4. 验证配置是否成功 #

重启终端后执行func --version，若能正常显示版本号，说明配置完成，此时回到VS Code重新运行TypeScript Azure Functions即可。

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