vscode调试小程序云函数必须先确保node.js被正确识别，否则require报错、cloud对象undefined、断点不命中；需用终端执行code --no-sandbox .启动（macos/linux），或手动添加node路径到系统path（windows），并在vscode内置终端验证node -v有输出。
VSCode 里写小程序云函数，缺的不是“库”，而是 Node.js 运行时本身没被正确识别——所有 require 报错、cloud 对象 undefined、断点不命中，根源都在这里。
VSCode 找不到 node 命令的典型表现
你在终端里执行 node -v 能输出版本号，但 VSCode 内置终端（Ctrl+`）或调试器一运行就报 command not found: node 或 Cannot find module。这不是插件没装，是 VSCode 启动时根本没加载到系统 PATH。
- macOS/Linux：从 Dock 或 Spotlight 启动 VSCode，不会读
~/.zshrc；必须用终端执行code --no-sandbox .启动 - Windows：Node.js 安装时没勾选
Add to PATH，导致系统级环境变量缺失；需手动把C:\Program Files\nodejs\加进“系统变量 → PATH” - 验证方式：在 VSCode 内置终端里直接敲
node -v，有输出才算真正生效；没输出就别配launch.json
require('fs') 没补全、fs.readFile 不显示参数签名
这说明 VSCode 的 TypeScript 语言服务没加载 @types/node，或者项目配置没告诉它“这是 Node.js 环境”。
- 必须安装类型定义：
npm install --save-dev @types/node（注意不是@types/nodejs，后者已废弃） - 项目根目录要有
jsconfig.json，且至少包含："compilerOptions": {"lib": ["es2020", "node"]} - 如果用了 ESM（
package.json里有"type": "module"），还要加"allowJs": true和"checkJs": true，否则 JSDoc 注释不生效 - 按
Ctrl+Shift+P输入TypeScript: Restart TS server强制刷新语言服务，比重启 VSCode 更快
云函数里 cloud.getWXContext() 返回空对象
这不是 SDK 问题，是本地根本没走云函数上下文注入流程——你可能误用了微信开发者工具的“本地模拟器”，或者没启动 @cloudbase/cli 的调试服务。
- 微信开发者工具右键“在本地模拟器中运行” ≠ VSCode 可调试；它绕过 Node.js 调试协议，断点完全无效
- 真能调试的唯一路径：全局安装
@cloudbase/cli，然后在项目根目录执行cloudbase functions:dev --function-name yourFunc - 该命令会启动一个带
--inspect=0.0.0.0:9229的进程，VSCode 必须用attach模式连接，launch模式会报ReferenceError: cloud is not defined - 确保
cloudbaserc.json里envId和region正确，否则cloud初始化失败，getWXContext()就是空的
调试时 process.env 缺失关键变量（如 TCB_ENV）
云函数本地调试依赖 CLI 注入环境变量，不是靠 .env 文件或手动 export。
-
cloudbase functions:dev启动时自动注入TCB_ENV、ENV_ID、REGION等，这些是cloudSDK 初始化所必需的 - 不要在代码里写
process.env.TCB_ENV = 'xxx'来硬编码，会导致线上/本地行为不一致 - 如果用了
dotenv，确保它只在非云函数环境加载（比如加个if (!process.env.TCB_ENV)判断），否则会覆盖 CLI 注入的值 - 检查
package.json的engines.node字段是否和云端 runtime 一致（如nodejs18.x），不匹配会导致process.env解析异常或 fetch 不可用
最常被跳过的一步是确认 node -v 在 VSCode 终端里真实可用——其他所有问题，包括 cloud 为空、require 失败、断点不触发，几乎都卡在这第一关。
