VSCode命令行启动失败主因是code未注册到PATH：Windows需检查安装时是否勾选“Add toPATH”或手动添加路径，macOS/Linux需通过软链接或Shell Command注册，并用code --version验证；若报错则逐层排查环境变量、用户数据目录权限及扩展冲突。
VSCode 命令行启动失败，基本不是 code 命令本身坏了，而是环境、路径或参数没对上——先验证能否输出版本号，再逐层排查。
code --version 报 command not found 怎么办
这是最基础的连通性问题，说明系统根本找不到 code 可执行文件。
- Windows：检查安装时是否勾选了“Add to PATH”；若没勾选，手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量 PATH - macOS：官网 .zip 包解压后默认不注册
code，需运行sudo ln -s /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code /usr/local/bin/code - Linux（.tar.gz）：解压后
code在bin/子目录下，建议软链到/usr/local/bin/code或加进$PATH - 注意：Snap/Flatpak 安装的 VSCode 通常不提供全局
code命令，优先换用官网二进制包
code --verbose 启动卡在 Starting VS Code 就不动
命令行能跑起来，但没后续日志，说明主进程卡在初始化早期环节，常见于用户数据目录权限异常或路径损坏。
- 检查
%APPDATA%\Code（Windows）、~/Library/Application Support/Code（macOS）、~/.config/Code（Linux）是否被设为只读或归属错误（如属 root） - 临时重命名该目录为
Code-backup，再运行code --verbose—— 若能继续输出日志并进入空窗口，就是它的问题 - Linux/macOS 下出现
EACCES错误，大概率是~/.vscode/extensions或User Data/Cache权限错乱，运行chown -R $USER:$USER ~/.vscode修复（别碰/usr/share/code）
code --disable-extensions 启动正常，但加参数就报错
禁用扩展能过，说明问题出在扩展加载链或其依赖项；但加了 --disable-gpu 或 --no-sandbox 反而失败，往往是参数冲突或 Electron 兼容性问题。
-
--disable-gpu和--no-sandbox不要单独滥用：前者解决渲染崩溃，后者绕过沙箱限制，但合用可能触发 Chromium 内部校验失败 - Windows 上若报错
ERROR: Failed to get user data dir，检查注册表HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders中Local AppData值是否被篡改 - macOS Sequoia + 新显卡驱动下，
--disable-gpu-sandbox比--disable-gpu更有效；Linux 容器中则必须加--no-sandbox并确保有cap_sys_admin权限 - 避免在
argv.json里硬写"enable-proposed-api": true这类非常规字段，某些扩展会据此做非法调用导致宿主退出
终端输出 ERR! spawn ENOENT 或 timeout 是什么情况
这类错误不是 VSCode 自身崩溃，而是它试图调用外部程序失败，典型如语言服务器、Git、Python 解释器等缺失或路径不对。
-
ERR! spawn ENOENT：比如 ESLint 扩展找不到全局eslint命令，或 GitLens 调用git失败——检查PATH是否包含对应工具路径 -
timeout类错误常出现在code --status输出末尾，显示某扩展Activating extension 'esbenp.prettier-vscode'卡住超过 10 秒，重点查该扩展的package.json是否声明了错误的activationEvents - settings.json 中若有语法错误（如多逗号、引号不闭合），VSCode 不报错，但会导致扩展 host 初始化失败，静默卡死——临时重命名
settings.json快速验证
真正难定位的从来不是“能不能启动”，而是“启动时哪一行日志断了”。code --verbose 的最后一行、main.log 的末尾、终端里最后一个 ERR!，这三个地方盯紧了，90% 的命令行启动问题不用重装就能闭环。
