VSCode部署依赖插件和CLI工具，90%失败因本地CLI未安装、未登录或项目结构不符；Azure需Azure Account与Azure App Service双扩展并重启；Heroku需正确安装CLI、登录并配置Procfile；部署前须检查端口监听、启动文件及环境变量。
VSCode 本身不直接部署应用，它靠插件或终端调用云平台 CLI 工具完成部署。部署失败，90% 是因为本地 CLI 未装好、未登录，或项目结构不满足平台要求。
Azure App Service 部署点不动？先查 Azure Account 和 Azure App Service 扩展是否都装了
两个扩展缺一不可：Azure Account 负责登录和订阅管理，Azure App Service 才提供“Deploy to Web App”命令。只装后者会报错 command 'azureAppService.Deploy' not found。
- 安装后必须重启 VSCode（或执行
Developer: Reload Window），否则命令不注册 - 按
Command+Shift+P输入Azure: Sign In，浏览器弹出失败？检查网络能否访问 login.microsoftonline.com - 登录成功后，在资源管理器底部应显示当前订阅名称；没显示=没真正登录
- 部署前确认工作区根目录有启动文件：Node.js 项目要有
package.json，Python 项目要有requirements.txt，.NET 项目要有.csproj
Heroku 插件点击无反应？大概率 heroku-cli 根本没装进系统 PATH
VSCode Heroku 插件只是外壳，所有操作最终调用 heroku 命令。npm 安装的版本常因权限或 shell 配置找不到，推荐用官方安装包。
- 在终端运行
heroku --version，无输出或报command not found→ 重装 CLI（去 heroku.com/cli 下载 dmg/pkg） -
heroku login后必须完成浏览器授权，否则插件部署时卡在 “Authenticating…” - 项目根目录必须有
Procfile，内容如web: npm start（冒号后必须有空格），且package.json中"start"脚本要监听process.env.PORT - 部署失败别瞎点重试——打开 VSCode 底部
OUTPUT面板，下拉选Heroku标签，日志里会明确写 “No Procfile” 或 “Web process failed to bind”
想精细控制部署参数？绕过插件，用 az 或 heroku 命令直接在 VSCode 终端里跑
图形化向导省事但限制多，比如 Azure 不让你指定 VNet，Heroku 无法设自定义域名。这时候就得切到集成终端手动执行 CLI。
- 确保
az --version和heroku --version都能返回结果，且已az login/heroku login - 在 VSCode 里用
Terminal → New Terminal启动的终端，环境变量和 PATH 与你日常终端一致 - Azure 示例：创建 Linux App Service 并部署 ZIP 包
az webapp up -n myapp -g myrg --sku B1 -l "East US" --htmlaz webapp deployment source config-zip -g myrg -n myapp --src ./dist.zip - Heroku 示例：跳过插件，用 Git 推送部署
heroku git:remote -a your-app-namegit push heroku main
部署后打不开页面？重点检查端口、路由和平台默认行为
不是代码问题，而是云平台对入口和暴露方式有硬性约定。本地能跑 ≠ 云端能跑。
- Azure App Service 默认只暴露 80/443，你的 Node.js 服务不能硬写
listen(3000)，得用process.env.PORT || 3000 - Heroku 动态分配
$PORT，且只认Procfile里声明的web:进程类型，其他进程（如worker:）不会对外暴露 - 静态网站部署到 Azure Storage 或 Vercel 时，入口 HTML 必须叫
index.html，路径必须在根目录，否则返回 404 - 用
curl -v http://your-app-url看响应头和状态码，比反复刷浏览器快得多
最容易被忽略的是：CLI 工具的登录状态是全局共享的，但 VSCode 插件可能读不到 shell 的环境变量；部署失败时第一反应不该是重装插件，而是打开 OUTPUT 面板看原始命令和错误输出。
