vscode中node.js环境失效主因是path未同步、launch.json路径写死或node版本与工具链不兼容；需通过终端启动vscode、验证path、用${file}动态指定program，并降级至node.js 18.x解决sap fioritools的tls握手失败。
Node.js环境在VSCode里跑不起来，90%不是缺插件，而是PATH没生效、launch.json写死了路径、或Node版本和UI5/Fiori工具链不兼容。
node -v能用但VSCode终端报“command not found”
这是Windows/macOS上最常被忽略的PATH同步问题：Node.js安装时勾选了“Add to PATH”，但VSCode是通过图形界面启动的，它不会自动继承系统shell（如PowerShell或zsh）的PATH更新。
- Windows用户：关掉所有VSCode窗口，用
code --new-window从命令行启动，或右键开始菜单→“VS Code (Admin)”重新加载环境变量 - macOS用户：不要双击.app图标启动，改用终端执行
code；若用Alfred/Spotlight，需在Shell中运行code --install-extension ms-vscode.vscode-node-asset后重启 - 验证方式：在VSCode内置终端里执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出中包含Node.js安装路径（如/Users/xxx/.nvm/versions/node/v18.12.1/bin）
launch.json里program字段为什么不能写死app.js
写成"program": "./app.js"看似简单，实则导致调试器每次只能跑固定文件——切换到server.js就得手动改配置，且无法支持多入口项目（如同时调试API服务和CLI工具）。
- 正确做法是设为
"program": "${file}"，这样按F5时自动调试当前打开的JS文件 - 如果想默认调试
index.js，用"program": "${workspaceFolder}/index.js"，但要确保该文件存在，否则调试直接失败 - 注意
${file}只在“当前文件”模式下有效；若用“npm script”模式（如"runtimeExecutable": "npm"），必须配"runtimeArgs": ["run", "dev"]并确保package.json里有对应脚本
ESLint + Prettier协同失效的典型表现
保存后代码没自动格式化、ESLint警告不显示、或者Prettier把import语句重排后ESLint立刻报错——这说明二者规则冲突，且VSCode没明确指定谁主谁次。
- 必须在
settings.json中显式声明优先级："editor.defaultFormatter": "esbenp.prettier-vscode"，并开启"editor.formatOnSave": true - 在项目根目录加
.prettierrc，内容仅保留基础项：{"semi": false, "singleQuote": true}；复杂规则交给ESLint的rules处理（如quotes、no-unused-vars） - 禁用Prettier自带的ESLint集成：在
settings.json中加"prettier.eslintIntegration": false（新版已废弃，但旧工作区可能残留）
Node.js 17+与SAP FioriTools的SSL握手失败
执行fiori add app或ui5 serve时卡在Fetching metadata from https://...，终端报ERR_SSL_VERSION_OR_CIPHER_MISMATCH——这不是网络问题，是OpenSSL 3.0在Node.js 17/19中默认禁用TLS 1.0/1.1，而部分SAP后端服务尚未升级。
- 临时绕过（仅开发）：
export NODE_OPTIONS=--tls-min-v1.0（macOS/Linux）或set NODE_OPTIONS=--tls-min-v1.0（Windows CMD） - 根本解法：降级到Node.js 18.x LTS，它默认启用TLS 1.2且兼容OpenSSL 3.0.7+，与SAPUI5 1.108+工具链完全匹配
- 验证是否生效：运行
node -e "console.log(require('https').globalAgent.options.minVersion)"，输出应为'TLSv1.2'
真正卡住人的从来不是“怎么装”，而是环境变量何时加载、调试配置何时生效、以及不同工具链对TLS/SSL的隐式假设——这些细节不会报错，只会让命令静默失败。
