Heroku CLI未安装或VSCode未识别导致“Deploy to Heroku”无响应或报错command 'heroku.deploy' not found；需确认heroku --version输出正常、完成heroku login、重启VSCode，并确保项目含正确Procfile和运行时文件（如package.json），且代码监听process.env.PORT。
VSCode 里点“Deploy to Heroku”没反应，或者报 command 'heroku.deploy' not found，基本可以确定：Heroku CLI 没装好，或 VSCode 根本没识别到它——插件只是个壳，不靠 CLI 就没法干活。
确认 Heroku CLI 是否真正可用
插件不会帮你装命令行工具，所有部署动作最终都转给 heroku 命令执行。本地没 CLI，点什么都白搭。
- 终端运行
heroku --version，必须有类似heroku/8.12.0 darwin-x64 node-v18.17.0的输出，才算安装成功 - 别只用
npm install -g heroku，Node 版容易因权限或 PATH 不生效；推荐去官网下载原生安装包（https://devcenter.heroku.com/articles/heroku-cli） - 装完必须运行
heroku login完成账号绑定（会自动打开浏览器授权） - VSCode 需要重启（或执行
Developer: Reload Window），否则找不到新加入的 PATH
项目根目录缺关键文件，部署必然失败
Heroku 不猜你用什么语言，它只看有没有 Procfile 和对应运行时声明文件。没有就直接拒收，不会提示“缺啥”，只会卡在构建阶段或报 No web processes running。
-
Procfile必须是 UTF-8 无 BOM 纯文本，首行不能有空格，格式为web: npm start（注意冒号后要空一格） - Node.js 项目必须有
package.json，且"scripts": { "start": "..." }中的命令要能监听process.env.PORT，硬写3000或8080会启动失败 - Python 项目需同时存在
requirements.txt和Procfile（如web: gunicorn app:app），少一个都不行 - C++ 项目不能直接部署，必须通过
heroku.yml+Dockerfile构建，Procfile里只能写容器启动命令（如web: ./app）
部署失败时，别瞎重装插件，先看 OUTPUT 面板
图形界面点一下就静默失败？弹窗没信息？那是因为真实日志全在 VSCode 底部的 OUTPUT 面板里，不是终端也不是通知栏。
- 点击 VSCode 底部状态栏的
OUTPUT，再从右上角下拉菜单中选Heroku - 里面会显示完整命令执行流：
git push heroku main是否触发、buildpack 是否匹配、npm install是否报错、npm start启动后是否立刻退出 - 常见陷阱：日志里出现
H10 (App crashed)，大概率是端口没读PORT环境变量；出现H14 (No web processes running)，说明Procfile不存在或格式错误
Heroku 插件不处理远程调试和本地运行逻辑
它只负责把代码推到云端、触发构建、拉起 dyno。本地能不能跑、断点怎么打、环境变量怎么模拟，得你自己配。
- 想本地模拟 Heroku 运行，得手动设
PORT=8080再跑npm start，或者用heroku local（需额外安装heroku-cli-local） - C++ 项目若用
vscode-cpptools调试，launch.json里的environment字段可加{"name": "PORT", "value": "8080"}，但这对云端部署完全无影响 - 插件不改 Git 远程地址、不管理 SSH 密钥、不处理多环境（staging/prod）切换——这些都得手动用
heroku git:remote或git remote add
最容易被忽略的一点：Heroku 的 PORT 是运行时注入的，且每次 dyno 启动都可能不同。任何把端口号写死在代码里、配置里、甚至 Procfile 里的做法，都会导致上线即崩。这不是插件问题，也不是 VSCode 问题，是部署平台的基本契约。
