Azure Functions Core Tools扩展安装失败：提示文件或目录不存在

我之前在旧版MacOS上折腾Azure Functions扩展安装时也碰到过类似的"No such file or directory"错误，结合你的环境信息，给你几个实际可行的排查方向和解决方案：

你当前使用的Azure Functions Core Tools是非常早期的beta版本（v2.0.1-beta.25），这个版本不仅功能不完善，还存在不少路径和兼容性bug，再加上你要安装的CosmosDB扩展是3.0.0-beta6的预览版，两者的版本匹配度很差，大概率是导致错误的核心原因。

1. 优先升级Azure Functions Core Tools到稳定版 #

旧版beta工具的问题太多，直接升级到官方支持的稳定版是最有效的解决办法：

• 先卸载旧版本：

  npm uninstall -g azure-functions-core-tools@2.0.1-beta.25
  

• 安装最新的v3稳定版（v2版本已经停止官方支持了）：

  npm install -g azure-functions-core-tools@3 --unsafe-perm true
  

  这里的--unsafe-perm参数是为了绕过MacOS上的权限限制，确保工具能正确创建系统级的命令链接。

2. 确保在正确的目录下执行扩展安装 #

升级工具后，一定要切换到你的Azure Functions项目根目录再执行安装命令，同时建议使用稳定版的CosmosDB扩展（避免beta版的兼容性问题）：

• 进入项目文件夹：

  cd /path/to/your/function-project-folder
  

• 安装兼容v3工具的稳定版CosmosDB扩展：

  func extensions install --package Microsoft.Azure.WebJobs.Extensions.CosmosDB --version 3.1.1
  

3. 手动修复PATH环境变量（如果升级后仍报错） #

如果升级工具后还是提示找不到文件，可能是MacOS的PATH环境变量没有包含func命令的安装路径：

• 先找到func命令的安装位置：

  which func
  

• 检查这个路径是否在你的PATH里：

  echo $PATH
  

• 如果不在，把它添加到你的shell配置文件里（比如_{/.bash_profile或}/.zshrc，根据你使用的shell选择）：

  # 替换成你实际查到的func路径
  echo 'export PATH="$PATH:/usr/local/lib/node_modules/azure-functions-core-tools/bin"' >> ~/.bash_profile
  source ~/.bash_profile
  

4. 调整Node.js版本到兼容范围 #

虽然你试过v8和v9，但v3版的Azure Functions Core Tools推荐使用Node.js 12.x或14.x的LTS版本，旧版Node.js可能会和工具的依赖产生冲突，建议升级到Node.js 14 LTS版本（用nvm管理版本会更方便）。

完成上述步骤后，先执行func --version确认工具版本是v3.x，然后在项目目录下执行func extensions list，如果能看到Microsoft.Azure.WebJobs.Extensions.CosmosDB的条目，就说明安装成功了。

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