vscode中node环境问题根源在系统配置：先验证终端中node -v/npm -v是否可用，检查path路径及权限；ocr开发应优先使用官方sdk而非手写http请求，并注意路径、鉴权、超时与返回结构处理。
VSCode里Node环境没起来？先确认node和npm是否真可用
很多问题其实卡在基础环境没配对——不是VSCode的问题，而是终端里node -v或npm -v报错或返回空。VSCode自带的集成终端（Ctrl+`）默认继承系统PATH，但Windows用户常遇到PowerShell策略限制或Git Bash未加入PATH的情况。
- 在VSCode终端里直接运行
which node（macOS/Linux）或where node（Windows），看路径是否指向你安装的Node版本（比如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 如果找不到，别急着改VSCode设置，先在系统命令行验证
node -v；不行就重装Node（推荐用https://nodejs.org/官网LTS版，别用包管理器装的“阉割版”） - 确认
npm config get prefix输出的是用户可写路径（如~/.npm-global），否则后续npm install可能权限失败
调用OCR接口前，得选对SDK——别硬写HTTP请求
第三方OCR（比如百度OCR、腾讯云OCR、阿里云OCR）都提供官方Node SDK，比自己拼axios或fetch发POST请求更稳。SDK封装了鉴权、签名、文件二进制上传、错误码映射这些细节，自己实现容易在access_token过期、multipart/form-data边界符、图片base64编码格式上翻车。
- 以百度OCR为例：
npm install baidu-aip-sdk后，const { TextRecognitionClient } = require('baidu-aip-sdk');就能直接初始化客户端 - 注意AK/SK别写死在代码里——用
.env文件存BAIDU_APP_ID、BAIDU_API_KEY、BAIDU_SECRET_KEY，再用dotenv加载 - 图片路径必须是本地绝对路径（
path.resolve(__dirname, 'sample.jpg')），SDK内部会读取文件流，传相对路径或URL会直接报ENOENT
VSCode调试时图片读取失败？检查__dirname和工作目录
VSCode默认调试启动的工作目录是打开的文件夹根目录，但你的图片可能放在./images/下，而代码里写的是fs.readFileSync('./images/test.jpg')——这时./指的不是代码文件所在目录，而是项目根目录。Node里没有“相对于当前文件”的路径语法，全靠__dirname。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 正确写法：
const imagePath = path.join(__dirname, '../images/test.jpg');（假设JS文件在src/下） - 调试时加一句
console.log('cwd:', process.cwd(), 'dirname:', __dirname);，立刻看清路径差异 - 如果用
vscode-js-debug（新版默认调试器），可在.vscode/launch.json里加"cwd": "${workspaceFolder}/src"来统一工作目录
OCR识别结果乱码或字段缺失？重点查Content-Type和返回结构
百度/腾讯OCR返回的JSON里，文字内容在words_result数组里，每个元素是{words: "文本"}，不是<code>text或content。另外，中文识别结果本身没问题，但如果你用console.log(res)只看到[Object]，是因为Node默认不展开深层对象——这容易误判为“没识别出来”。
- 打印时用
console.log(JSON.stringify(res, null, 2))或util.inspect(res, {depth: null}) - 某些OCR服务对图片尺寸有限制（如百度要求宽高≤4096px），超限会静默截断，返回结果变少——先用
sharp缩放再传 - 网络请求超时常见于国内云服务SDK默认timeout太短（如腾讯云默认5秒），需显式配置：
client.setOptions({timeout: 30000})
真正麻烦的是OCR服务商的token刷新逻辑和并发限制——这些不会在VSCode里报错，但会突然返回401或429，得看响应头x-req-id和文档里的错误码表。别指望一次配置永远有效。
