code --version 无输出说明 VS Code 的 Shell Command 功能未启用，需在已打开的 VS Code 中运行“Shell Command: Install 'code' command in PATH”，并重启终端；macOS/Linux/Windows 均适用，Snap/Flatpak 安装版除外。
code --version 无输出，说明 CLI 根本没注册
执行 code --version 是验证命令行工具是否可用的唯一可靠方式。没输出、报 command not found: code，不是路径写错或权限问题，而是 VS Code 的 Shell Command 功能压根没启用。
解决方法只有一条：在任意已打开的 VS Code 窗口中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并运行 Shell Command: Install 'code' command in PATH；然后必须关闭所有终端窗口，**重新打开一个新终端**——PATH 变更不会生效于已有终端进程。
- macOS 用户尤其注意：即使 VS Code 已安装，
code命令默认不可用，这步操作不可跳过 - Windows 用户若用便携版、企业策略禁用，或重装时跳过了勾选框，也会遇到同样问题
- Linux 下通过 Snap/Flatpak 安装的版本，
code命令行为受限，建议改用官网.tar.gz包解压后手动添加软链
code . 总复用旧窗口，加 --new-window 才算真正新开
code . 默认复用已有窗口，这是 VS Code 的单实例设计，不是 bug，但不符合“启动新窗口”的实际需求。要强制开启独立进程和干净工作区，必须显式带上 --new-window 参数。
正确写法只有这一种：code --new-window . —— 在当前终端所在目录启动新窗口，并自动打开该文件夹。
-
--new-window不可省略，漏掉就等于没写 - 点号
.表示当前目录，也不能省；换成空格或留空会导致打开空白窗口 - 路径含空格无需引号：
code C:/My Projects/app合法，VS Code 内部已处理 - 路径末尾多加斜杠（如
code C:/project/）可能触发解析异常，导致左侧资源管理器为空
code --status 卡在 “Activating extension” 就是插件问题
运行 code --status（macOS/Linux）或在 Windows PowerShell 中执行相同命令），如果输出停在 Activating extension 'xxx'、长时间无响应，或末尾出现 ERR! spawn ENOENT、Extension host terminated unexpectedly，基本可锁定是某个扩展崩溃阻塞了整个启动流程。
此时不要重装 VS Code —— 插件初始化失败不影响核心进程，但会卡住 UI 渲染链路。
- 先用
code --disable-extensions验证：能正常启动 → 100% 是扩展问题 - 再用
code --list-extensions查出全部已安装插件，重点关注ms-python.python、esbenp.prettier-vscode、bradlc.vscode-tailwindcss等含原生模块或近期更新过的高危插件 - 逐个禁用：例如
code --disable-extension ms-python.python；某些旧插件（如vscode-icons）即使被禁用，也可能通过劫持argv.json干扰启动，需手动删掉其安装目录
code --verbose 输出 ERROR: Failed to get user data dir 或 EACCES 权限错误
code --verbose 是图形界面静默失败时最底层的诊断入口。它不依赖 GUI 渲染，直接暴露主进程初始化链路。其中两类错误最典型：
ERROR: Failed to get user data dir → Windows 注册表项 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders\Local AppData 被篡改，需手动修复；
Unable to read file '/user-data-dir/Cache/' (Error: EACCES) 或类似 EACCES: permission denied → 用户数据目录权限异常，常见于用 sudo code 启动污染了 ~/.vscode 所属用户，或磁盘挂载为只读。
- 修复权限：运行
chown -R $USER:$USER ~/.vscode（Linux/macOS），但切勿递归修改/usr/share/code等系统路径 - Windows 用户检查
%APPDATA%\Code所在磁盘是否只读，NTFS 权限是否丢失 - 符号链接指向失效路径（如
%USERPROFILE%\.vscode\extensions指向已删除的安装目录）也会触发同类错误，需用dir %USERPROFILE%\.vscode\extensions检查链接有效性
复杂点在于：多个问题可能叠加出现。比如 code --version 失败 + code --disable-extensions 也无效，大概率是 CLI 未注册 + 用户数据目录损坏同时存在。排查时务必分层隔离，别指望一步到位。
