VSCode调试Node.js时生成不完整终端命令无法启动如何解决？

根因说明 #

该问题触发原因是VSCode调试时会把所有环境变量拼接为命令行前缀传入集成终端，PATH过长导致总命令长度触发zsh行编辑/VSCode终端集成的输入缓冲区限制，进而出现命令截断、不自动执行的问题：

• 命令末尾的%是zsh的不完整行标识，代表上一段输入没有携带结束换行符
• 第一次手动回车补全了换行符，后续调试复用了终端的环境变量缓存，不再拼接长前缀，因此运行正常
• ARG_MAX是系统级的命令参数长度上限，本问题触发的是终端模拟器/ shell行编辑层的缓冲区限制，远小于ARG_MAX，所以查询到的ARG_MAX数值大不影响该问题出现

可落地解决步骤 #

• 第一步：优化PATH长度，清理~/.zshrc中重复的PATH导出逻辑，使用去重写法减少PATH总长度：

# 替换原有的多段PATH export，统一用如下写法自动去重
typeset -U path
path=(
  ~/.nvm/versions/node/v14.17.1/bin
  ~/.pyenv/shims
  ~/.pyenv/bin
  /usr/local/bin
  /usr/bin
  /bin
  /usr/sbin
  /sbin
  /usr/local/share/dotnet
  ~/.dotnet/tools
  /Library/Apple/usr/bin
  /Library/Frameworks/Mono.framework/Versions/Current/Commands
)
export PATH

• 第二步：关闭VSCode集成终端的shell集成功能，避免长命令输入异常：
  打开VSCode设置，搜索terminal.integrated.shellIntegration.enabled，取消勾选该选项，重启VSCode生效
• 第三步：调整Node调试配置，避免环境变量拼接至命令行：
  打开项目下.vscode/launch.json，将调试配置修改为如下格式，由VSCode自动注入环境变量，而非拼接为命令前缀：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "调试Nodemon项目",
      "runtimeExecutable": "nodemon",
      "program": "${workspaceFolder}/.",
      "restart": true,
      "console": "integratedTerminal",
      "runtimeArgs": ["--nolazy"],
      "env": {}
    }
  ]
}

内容的提问来源于stack exchange，提问作者Mugshep