codegeex插件要求node.js≥22，缺失或版本不匹配会导致jwt签名失败、crypto api调用异常等；需在vs code终端执行node -v验证实际生效版本，并确保环境变量正确加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX 插件在 VS Code 中运行时，部分核心功能（如本地模型推理、JWT 工具生成、TypeScript 类自动补全等）会调用 Node.js 运行时执行代码分析与编码逻辑，若 Node.js 缺失或版本不匹配，将导致插件报错“command not found”、签名失败、base64url 编码异常或类型约束丢失。
确认是否已安装 Node.js
打开 VS Code 内置终端（Ctrl+`），输入：
node -v
若返回类似 v22.2.0 的版本号，说明已安装；若提示“不是内部命令”，则未安装或未加入 PATH。
验证 Node.js 版本是否满足 CodeGeeX 要求
CodeGeeX 自 2026 年起要求 Node.js ≥ 22，低于此版本会导致 crypto.subtle 或 crypto.createHmac 调用失败，JWT 签名结果不合法。
执行以下命令检查实际生效版本：
node -v → npm -v
【注意】不要依赖安装包名称判断版本，必须在当前 VS Code 终端中执行 node -v。某些系统存在多版本共存，VS Code 启动时可能加载的是旧版 shell 环境。
Windows 用户特别检查项
第一步：右键“此电脑”→属性→高级系统设置→环境变量→查看系统变量 Path 中是否存在 Node.js 安装路径（如 C:\nodejs\）；
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
第二步：在 PowerShell 中运行 $env:Path.Split(';') | Select-String nodejs，确认输出路径与 VS Code 终端中 which node 一致；
第三步：若不一致，重启 VS Code 并勾选「重新加载窗口」，否则插件仍会读取旧环境变量。
这一步跳过会导致插件识别到 v16.x 却误判为兼容，后续 JWT 编码时因缺少 globalThis.crypto 报错。
Mac 与 Linux 用户快速修复方案
方法一：使用 nvm 切换至 22 LTS
nvm install 22 → nvm alias default 22 → nvm use 22
方法二：直接重装 Node.js 22 LTS（推荐官网 .pkg/.tar.xz 包）
下载地址：https://nodejs.org/dist/v22.14.0/
安装后执行 source ~/.zshrc（Mac）或 source ~/.bashrc（Linux），再启动 VS Code。
