VSCode本身不运行Firebase函数，全靠firebase-tools CLI启动本地Emulator Suite；必须全局安装CLI并确保VSCode终端能识别，配置launch.json为attach模式连接Functions Emulator的Node子进程，且需启用sourceMap、正确设置host与端口、确保服务联动。
VSCode 本身不运行 Firebase 函数，也不“模拟云端”——它只负责编辑和调试，真正的模拟全靠 firebase-tools CLI 启动的本地 Emulator Suite。如果你在 VSCode 里点运行却没反应、断点不生效、函数不触发，90% 的问题出在 CLI 没跑起来，或没连上它的 Node 子进程。
确认 firebase-tools 能被 VSCode 终端识别
这是所有后续操作的前提。VSCode 内置终端和系统终端不是一回事，很多人的 firebase --version 在 Terminal.app 或 PowerShell 里能跑，但在 VSCode 里报 command not found。
- 在 VSCode 内置终端执行
firebase --version，必须输出类似13.24.0；否则说明 CLI 未安装，或安装了但路径没继承进来 - 若未安装：运行
npm install -g firebase-tools（别加--save-dev，全局才有效） - 若已安装但 VSCode 不识别：打开 VSCode 设置，搜
terminal.integrated.inheritEnv，确保设为true，然后**重启 VSCode** - 首次使用前必须运行
firebase login --interactive，否则emulators:start会卡在认证环节，无任何错误提示
firebase emulators:start 启动后，函数为什么没日志？
Emulator Suite 是多个服务的集合，默认只启动 Functions，但你的函数很可能依赖 Firestore 或 Auth 触发器。比如写了个 onDocumentCreated，结果死活不执行——大概率是 Firestore Emulator 根本没开。
- 启动前确认项目已初始化对应服务：
firebase init functions和firebase init firestore（或其他你用到的服务） - 启动时加
--only functions,firestore,auth显式指定，避免漏掉联动服务 - 检查
firebase.json中emulators.functions.port是否被其他进程占用（如另一个 Node 服务占了 5001） - Functions 默认监听
http://localhost:5001，UI 地址是http://localhost:4000；在 UI 的 Functions 标签页点击函数名可手动触发 HTTP 函数
VSCode 断点不生效？关键在 attach 模式和端口匹配
Functions Emulator 启动的是一个父进程，它 fork 出实际执行函数逻辑的子进程。VSCode 的 launch 配置无法直接启动这个子进程，必须用 attach 模式连接其 --inspect 端口。
- 新版
firebase-tools（≥13.0）默认启用动态调试端口，不再固定为 9229；必须显式加参数：firebase emulators:start --inspect-functions=0.0.0.0:9229 - VSCode 的
launch.json必须是request: "attach"，不能是"launch"；port值要和 CLI 参数一致（这里是 9229） -
localRoot设为"${workspaceFolder}/functions"，确保源码路径和调试器映射正确 - 如果用了 TypeScript，确认
tsconfig.json里"sourceMap": true已开启，否则断点会打在编译后的 JS 行上
HTTP 函数能调，但 Firestore 触发器不响应？查联动配置
Functions Emulator 和 Firestore Emulator 是两个独立进程，它们之间靠环境变量和网络通信联动。默认情况下它们能自动发现彼此，但某些网络环境（如 Docker 容器、WSL2、公司代理）会阻断这个发现机制。
- 启动时强制指定地址：
firebase emulators:start --inspect-functions=0.0.0.0:9229 --host=0.0.0.0 - 检查
firebase.json中emulators.firestore.host和emulators.functions.host是否都设为0.0.0.0（而非默认的localhost） - 在 Functions 代码中，确保初始化 SDK 时指向本地模拟器，例如：
admin.firestore().settings({ host: 'localhost:8080', ssl: false }) - 最简单的验证方式：在 UI 的 Firestore 标签页手动添加一条文档，看 Functions 日志是否立刻输出
真正容易被忽略的不是配置项本身，而是“谁在监听谁”。Functions Emulator 默认只监听 127.0.0.1，而 VSCode attach、Firestore 联动、甚至 curl 测试都可能走 localhost 或 0.0.0.0——这三者在某些系统上行为不等价。端口、host、sourceMap、服务联动，四个点缺一不可。
