nativescript调试需先确保cli环境正常：运行tns --version（≥8.4）和tns doctor验证sdk、jdk17、node.js≥18等依赖，并用adb devices或xcrun simctl list devices确认设备连接；vscode调试须手动配置launch.json，推荐使用npx tns run android --no-hmr --device指定设备，且outfiles须精准指向platforms/下js文件；chrome devtools更可靠，建议用tns run android --debug-brk或chrome://inspect直接调试，避免vscode源码映射失效。
NativeScript CLI 必须先能独立运行
VSCode 不执行 NativeScript 构建或部署，它只调用 tns 命令。如果 tns run android 或 tns run ios 在终端里失败，VSCode 调试必然失败。
先验证 CLI 状态：
- 运行
tns --version，确认输出 ≥ 8.4（当前稳定版） - 执行
tns doctor，逐项检查 Android SDK、Xcode、Java、Node.js 版本是否满足要求（JDK 17、Node.js ≥ 18） - 确保
adb devices能列出已连接设备或模拟器（Android）；xcrun simctl list devices能显示 iOS 模拟器（macOS）
若 tns run android 报错 “Command not found” 或卡在 “Preparing project…”，别急着配 VSCode —— 先修 CLI 环境。
VSCode 中启用 NativeScript 调试需手动配置 launch.json
NativeScript Tools 官方插件已停止维护，VSCode 不再提供开箱即用的调试模板。你必须手动创建 .vscode/launch.json，且配置必须匹配你实际使用的运行命令（tns run vs tns debug）。
推荐使用以下最小可行配置（适用于 Android 真机/模拟器）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch on Android",
"type": "node",
"request": "launch",
"runtimeExecutable": "npx",
"runtimeArgs": ["tns", "run", "android", "--no-hmr", "--device", "emulator-5554"],
"port": 9229,
"sourceMaps": true,
"outFiles": ["${workspaceFolder}/platforms/**/*"],
"skipFiles": ["<node_internals>/**"]
}
]
}</node_internals>
关键点说明：
-
--no-hmr关闭热模块替换，避免断点被跳过 -
--device显式指定设备 ID（用adb devices查），不填则默认首台设备，易出错 -
outFiles指向platforms/下生成的 JS 文件，否则断点无法映射到源码 - iOS 调试需改用
"runtimeArgs": ["tns", "run", "ios", "--no-hmr"]，且必须在 macOS 上运行
Chrome DevTools 是更可靠的替代调试入口
VSCode 的 Node.js 调试器对 NativeScript 的 TypeScript 源码映射支持不稳定，尤其在 HMR 启用或模块动态加载时，断点常失效或停在 bundle.js 而非 .ts 文件。
更稳的做法是绕过 VSCode，直接用 Chrome：
- 启动应用：
tns run android --debug-brk（会自动打开 Chrome 并停在入口） - 或运行后访问
chrome://inspect→ 找到 “NativeScript app” → 点击 “Inspect” - 此时可设断点、查看
console.log、执行表达式，且源码映射（Source Map）通常比 VSCode 准确
注意：--debug-brk 会让 JS 线程启动即暂停，适合调试初始化逻辑；普通 tns run 后再连 chrome://inspect 则需等 App 加载完成。
调试时容易忽略的路径与缓存陷阱
NativeScript 项目结构和构建产物路径对调试成败影响极大，但文档极少强调：
-
platforms/目录下生成的 JS 文件路径与源码路径不一致，outFiles若写成"${workspaceFolder}/**/*.js"就会找不到映射，断点永远不触发 - 修改
launch.json后必须重启整个调试会话（Stop → Start），仅保存文件无效 -
tns clean和rm -rf platforms/ node_modules/ && npm install是解决“断点突然不生效”的最快手段 —— 缓存污染比想象中更频繁 - 真机调试时，USB 连接不稳定会导致
adb reverse tcp:9229 tcp:9229失败，表现为 Chrome 无法连接，此时重插线 + 重执行tns run android即可
真正卡住的时候，往往不是配置错了，而是 platforms/ 里残留了旧构建产物，或者 ADB 端口转发没建立成功 —— 这些细节比 launch.json 语法重要得多。
