PowerShell 中含空格路径需用双引号包裹，否则参数被错误拆分；Code Runner 和 tasks.json 需确保 $dir、args 等变量加引号；npm 脚本内调用也须转义或改用 require() 加载。
PowerShell 终端里直接运行含空格路径的 npm 脚本失败
报错像 npm : 无法将"my script.js"项识别为 cmdlet 或 The term 'my' is not recognized，本质是 PowerShell 把 npm run dev -- --config my config.js 拆成 npm、run、dev、--、--config、my、config.js 七个参数——后两者本该是一整个路径参数。解决方法只有一条：所有含空格的路径（包括脚本名、配置文件路径、--config 后的值）必须用双引号包裹。
-
npm run dev -- --config "my config.js"—— 参数值含空格时加双引号 -
npm run "my script.js"—— 脚本名含空格时，整个脚本名加双引号 - 单引号无效：
npm run 'my script.js'不会解析变量，且 PowerShell 不认作路径边界 - 反斜杠转义（
my\ script.js）在 PowerShell 中完全不生效
Code Runner 运行 npm 脚本时路径断开
如果你用 Code Runner 点击「运行」按钮执行 package.json 里的脚本，而项目路径含空格（比如 C:\My Projects\my-app），它大概率会卡在 The term 'Projectsmy-app' is not recognized。这是因为 Code Runner 默认把 $dir 直接拼进命令字符串，没加引号，导致 PowerShell 在第一层就切开了路径。
- 打开 VSCode 设置 → 搜索
code-runner.executorMap→ 编辑settings.json - 找到
"npm"对应项，改成："npm": "cd \"$dir\" && npm run $fileNameWithoutExt" - 注意：双引号必须存在，且
$dir和$fileNameWithoutExt都要被双引号包裹；PowerShell 下不能省略cd命令前的引号 - 如果脚本名本身含空格（如
"start dev"），Code Runner 的$fileNameWithoutExt会变成start dev，此时必须手动改写为npm run \"start dev\"，否则仍会断开
tasks.json 中 npm 命令因空格路径执行失败
常见报错是 The term 'Projectsmy-app' is not recognized 或 Cannot find module 'my config.js'，根源是 JSON 字符串解析 + PowerShell 参数拆分双重作用：JSON 先按反斜杠和引号解析一次，PowerShell 再按空格切一次。
-
command字段值必须是完整字符串，且外层双引号不可省略："command": "npm run dev" - 所有含空格的参数都得在
args数组里单独作为字符串项，并用双引号包裹："args": ["run", "dev", "--", "--config", "my config.js"]→ 改成"args": ["run", "dev", "--", "--config", "my config.js"]（VSCode 会自动把每个数组元素当整体传给 shell） - 如果路径来自变量（如
${workspaceFolder}），确保它本身不含空格；若含空格，不要拼进args字符串，改用shell: true并手动加引号："args": ["sh", "-c", "npm run dev -- --config \"${workspaceFolder}/my config.js\""] - 禁用
shell: false时，args必须是列表，不能是拼好的字符串，否则空格照样被拆
npm 脚本内部调用含空格路径的子命令失败
比如 package.json 里写了 "scripts": { "build": "node build/my script.js" }，执行 npm run build 时会报 Cannot find module 'build/my'。这不是 VSCode 的问题，而是 npm 启动子进程时默认用 shell 执行，而 shell（尤其是 PowerShell）对空格路径处理不一致。
- 最稳妥做法：改用
cross-env或node --eval绕过 shell 解析："build": "node \"build/my script.js\""（注意外层双引号 + 内层转义） - 或者用 Node.js 原生方式加载：
"build": "node -e \"require('./build/my script.js')\"" - 避免在 script 字段里直接写带空格的路径；优先把逻辑抽到独立 JS 文件中，用
require()加载，由 Node.js 自己解析路径 - Windows 下尤其要注意：PowerShell 的
&调用操作符对引号嵌套敏感，& "node" "build/my script.js"可行，但node "build/my script.js"更稳
空格路径问题从来不是“路径非法”，而是每一层工具链（VSCode → 终端 → shell → npm → node）对参数边界的理解不一致。最容易被忽略的是：你改了 tasks.json，却忘了 package.json 里脚本自身也含空格路径；或者修好了 Code Runner，但终端里手动运行时又漏掉双引号。每次传参，都要问一句：这个字符串，有没有被某一层当成多个词切开？
