使用Azure Functions Core Tools发布Node.js函数应用的依赖项处理疑问

本地依赖是否会被打包发送至Azure？ #

是的，默认情况下，func azure functionapp publish会将本地node_modules目录中未被.funcignore排除的依赖项打包，随应用代码一同发送到Azure。

默认.funcignore的规则说明 #

func new生成的默认.funcignore仅排除开发相关文件（如.vscode/、.git/、npm-debug.log等），并未设置忽略整个node_modules目录的规则。这意味着：

• 只要依赖未被.funcignore列入排除列表，就会被包含在发布包内
• 若需避免打包特定依赖，可手动在.funcignore中添加对应规则（例如特定包路径，或整个node_modules/，但不推荐全局排除，除非确认Azure可自动拉取依赖）

Azure从包注册表获取依赖的场景 #

存在以下几种情况，Azure会跳过本地打包的依赖，转而从npm等包注册表重新安装：

• 启用远程构建：发布时使用func azure functionapp publish --build remote参数，或在Azure门户开启远程构建设置，此时Azure会在云端执行npm install，直接从注册表拉取依赖，本地node_modules不会被使用。
• 使用--no-build参数发布：若发布时添加该参数，但应用未预先构建完整依赖包，Azure会尝试自动安装缺失依赖（此场景可能因运行时缺少构建工具导致部署失败）。
• 本地依赖异常：若本地打包的依赖存在损坏、与Azure运行时环境不兼容等问题，Azure可能会尝试重新安装对应版本的依赖（属于异常场景）。

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