VS Code部署Azure App Service报路径超260字符错误解决方案

触发报错信息：

"The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters"

该报错本质是Windows默认开启的260字符全路径长度限制，在你无法修改项目文件名、无法移动项目存储路径的前提下，可通过以下任意一种方式解决，所有方案均不会改动现有项目文件：

• 启用Windows系统长路径支持，从系统层面解除长度限制
  操作流程：
  1. 专业版/企业版Windows可按Win+R输入gpedit.msc打开本地组策略编辑器，依次展开计算机配置 > 管理模板 > 系统 > 文件系统，找到启用Win32长路径策略，设置为「已启用」，保存后重启电脑即可生效。
  2. 家庭版Windows无组策略功能，可按Win+R输入regedit打开注册表编辑器，定位到路径HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，将LongPathsEnabled的DWORD值修改为1，重启电脑生效。
• 修改Azure App Service扩展的临时部署目录为短路径
  报错的常见触发原因是扩展默认在当前项目路径下生成多层嵌套的临时部署暂存文件，叠加上原有项目路径长度突破限制。你可以直接修改扩展的临时目录配置绕开：
  1. VS Code内按Ctrl+,打开设置面板，搜索配置项Azure App Service: Temp Directory
  2. 将配置值修改为磁盘根目录下的短路径文件夹，比如C:\az_temp，提前手动创建好这个空文件夹即可。配置生效后扩展会把所有部署暂存文件存到该短路径下，不会再出现路径拼接过长问题。
• 手动压缩项目包通过Zip部署绕开本地扩展流程
  如果不想修改系统或扩展配置，可以完全绕开VS Code扩展的本地打包流程：
  1. 进入项目根目录，选中所有需要部署的项目文件，直接压缩为zip格式压缩包（注意不要把外层项目文件夹一并压缩，要保证压缩包根目录直接可见项目入口文件，如web.config、package.json、index.html等）
  2. 打开Azure门户进入对应App Service页面，找到部署中心选择Zip部署方式，上传本地压缩包即可完成部署，全程不会触发本地路径长度校验。
• 修改系统临时目录为短路径
  VS Code和Azure扩展默认会调用系统配置的TEMP目录存储临时文件，你可以把系统临时目录改成更短的路径减少长度占用：
  1. 右键「此电脑」选择属性 > 高级系统设置 > 环境变量
  2. 在当前用户的变量列表中找到TEMP和TMP两个配置项，将默认的长路径（一般为C:\Users\你的用户名\AppData\Local\Temp）修改为根目录下的短路径比如C:\temp，提前手动创建对应文件夹。
  3. 重启VS Code后再触发部署即可。

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