VSCode命令行启动失败90%是code命令未正确注册到PATH或环境变量、终端类型、权限配置冲突所致，需依次验证code命令可用性、PATH配置、权限设置、扩展干扰及终端兼容性。
VSCode 命令行启动报错，90% 不是安装失败，而是 code 命令本身没被正确注册到系统路径，或环境变量、终端类型、权限配置之间存在隐性冲突。先确认 code 命令能否执行，再逐层查来源、权限、上下文。
code 命令未找到：PATH 未生效或安装路径异常
在终端输入 code --version 报 command not found 或 'code' is not recognized，说明 shell 根本没识别到该命令。
- Windows 下检查
code.cmd是否真在 PATH 里：默认路径是C:\Users\，确认该目录已添加进系统或用户环境变量\AppData\Local\Programs\Microsoft VS Code\bin PATH - macOS/Linux 查
which code；若无输出，运行sudo ln -s /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code /usr/local/bin/code（macOS）或解压版需手动软链到/usr/local/bin - 某些终端（如 Git Bash、WSL2 中的 zsh）不读取 Windows 的 PATH，需在对应 shell 配置文件中显式追加：
export PATH="$PATH:/mnt/c/Users//AppData/Local/Programs/Microsoft VS Code/bin" - VSCode 安装时勾选了“Add to PATH”但未重启终端——关掉所有终端窗口再重开，否则 PATH 不刷新
code 启动后立即报错退出：权限或沙箱机制拦截
命令能识别，但执行 code 后瞬间退出、无窗口、终端也无日志，常见于 Linux/macOS 权限错位或容器环境限制。
- 报
Error: EACCES: permission denied, mkdir '/usr/share/code/resources/app/out/vs'：说明code尝试写入只读系统路径，大概率是用sudo code启动过一次，污染了~/.vscode所有者权限；运行chown -R $USER:$USER ~/.vscode修复（切勿对/usr/share/code递归 chown） - Linux 上跑在 Docker 或 WSL2 GUI 时出现
Failed to move to new namespace：必须加--no-sandbox，即code --no-sandbox；长期使用不安全，仅用于排查 - macOS M 系列芯片上启动极慢或卡在白屏：加
--disable-gpu --force-renderer-accessibility可绕过 Metal 初始化阻塞
code --status 卡在某个扩展：扩展激活超时引发主进程挂起
code --status 是最轻量的诊断命令，输出停在 Activating extension 'xxx' 多于 5 秒，基本锁定问题扩展。
- 先用
code --disable-extensions验证：能启动 → 100% 是扩展问题；再用code --list-extensions列出全部，重点关注最近更新的GitLens、ms-python.python、esbenp.prettier-vscode、中文语言包 - 精准禁用单个扩展：
code --disable-extension ms-python.python；若不确定，用二分法：先禁用前一半扩展名（空格分隔），成功则问题在另一半 - 有些扩展卸载不干净，残留
~/.vscode/extensions/ms-python.python-2026.x.x目录，手动删掉再试 - 禁用后仍卡住？检查
argv.json是否被插件修改过（路径：~/.vscode/argv.json），临时重命名它再启动
终端内执行 code 后中文乱码或命令解析失败
不是 VSCode 自身崩溃，而是当前终端编码或 shell 解析逻辑与 code 启动脚本不兼容，多见于中文 Windows + Git Bash / PowerShell。
- Git Bash 中执行
code报cannot execute binary file：因为code.cmd是 Windows 批处理，Git Bash 默认不调用 cmd.exe；改用cmd //c code - PowerShell 中报
File code.ps1 cannot be loaded：PowerShell 执行策略阻止了脚本运行；临时允许：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 中文路径下启动失败（如项目路径含中文）：VSCode 本身支持，但某些旧版扩展或 Python 插件会因
sys.getfilesystemencoding()返回mbcs而解析错误；统一用英文路径测试可快速隔离
真正难排查的不是报错信息本身，而是报错发生的上下文——同一台机器，PowerShell 里能启动，Git Bash 里不行；同一个 code 命令，在桌面终端可用，在 tmux 里就失败。这种差异往往藏在 shell 初始化、终端类型、甚至父进程的环境变量继承链里。别急着重装，先用 code --log trace --status 抓底层日志，看第一行初始化输出是否正常，比盯着 GUI 弹窗有效得多。
