VSCode远程SSH终端执行命令后出现bash: cd: too many arguments错误

问题详情 #

• 运行环境：Windows 10 主机，VSCode 版本 1.79，已安装扩展清单：

  4ops.terraform
  GitLab.gitlab-workflow
  hashicorp.hcl
  jasonn-porch.gitlab-mr
  ms-python.isort
  ms-python.python
  ms-python.vscode-pylance
  ms-toolsai.jupyter
  ms-toolsai.jupyter-keymap
  ms-toolsai.jupyter-renderers
  ms-toolsai.vscode-jupyter-cell-tags
  ms-toolsai.vscode-jupyter-slideshow
  ms-vscode-remote.remote-containers
  ms-vscode-remote.remote-ssh
  ms-vscode-remote.remote-ssh-edit
  ms-vscode-remote.remote-wsl
  ms-vscode-remote.vscode-remote-extensionpack
  ms-vscode.remote-explorer
  ms-vscode.remote-server
  RolandGreim.sample-ext 
  

• 异常表现：通过VSCode Remote SSH连接3台不同的Linux服务器时，Bash终端执行任意命令后都会触发错误：bash: cd: too many arguments；直接用SSH客户端登录这些服务器无此问题。
• 已做排查：新建远程连接、创建空白工作区，查看VSCode日志，搜索Stack Overflow相关内容，均未找到解决线索。
• 行为示例：执行ls、pwd等基础命令，命令本身能正常输出结果，但随后必定弹出上述cd参数过多的错误。

排查方向 #

1. 检查VSCode终端启动配置
   • 打开VSCode设置，搜索remote.SSH.defaultProfile和terminal.integrated.shellArgs.linux，确认是否存在错误的自定义cd命令参数，比如误将多个路径传给cd指令。
2. 排查远程服务器Bash配置文件
   • 尽管直接SSH登录正常，但VSCode Remote SSH可能加载额外的配置项。可以临时重命名~/.bashrc、~/.bash_profile、/etc/bash.bashrc这类文件，重启VSCode连接后测试是否还会报错，以此判断是否是配置文件中的指令导致问题。
3. 禁用扩展排查干扰
   • 先禁用所有非Remote SSH相关的扩展（比如Python、Jupyter、Terraform系列），再逐个重新启用，定位是否是某个扩展篡改了终端启动命令。
4. 切换终端类型测试
   • 在VSCode设置中搜索terminal.integrated.defaultProfile.linux，将默认终端切换为sh，测试是否还会出现相同错误，以此判断是否是Bash集成的问题。

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