code命令无反应需先检查是否加入path；windows用命令面板安装，macos/linux重启终端；.code-workspace须写全路径且加引号；code .与.code-workspace加载机制不同，不可混用。
code 命令没反应？先确认它是否已注册到 PATH
绝大多数“启动失败”其实根本没走到 VSCode 逻辑，而是 shell 根本找不到 code 这个命令。运行 code --version —— 如果报 command not found，就别试 code . 或路径了，直接停在这步处理。
- Windows：打开已运行的 VS Code，按
Ctrl+Shift+P，输入并执行Shell Command: Install 'code' command in PATH；若安装时没勾选 “Add to PATH”，需手动把C:Users{user}AppDataLocalProgramsMicrosoft VS Codein加进系统环境变量 - macOS/Linux：同样用命令面板触发该操作；注意重启终端（不是仅关 tab），否则 PATH 不生效
- WSL、Snap、.zip 解压版不支持该命令，得换官方安装包或改用绝对路径调用
Code.exe
加载工作区文件（.code-workspace）要写全路径，不能只写文件名
code 命令不会自动在当前目录下搜索 xxx.code-workspace 文件。它只认你明确传入的路径——哪怕文件就在当前目录，也得写成 code ./my-project.code-workspace，而不是 code my-project.code-workspace（后者会被当成普通文件打开，只显示内容，不加载工作区）。
- 推荐用绝对路径，避免歧义：
code /home/user/projects/backend.code-workspace - 路径含空格必须加英文双引号：
code "/Users/name/My Projects/frontend.code-workspace" - 不要加
--new-window参数，否则会强制新建窗口，绕过已有窗口的布局恢复逻辑
code . 是加载文件夹，不是加载工作区；二者行为完全不同
code . 启动的是单根工作区（single-root workspace），即把当前目录当项目根，所有设置、调试配置、扩展启用都基于这个文件夹。而 .code-workspace 是多根工作区（multi-root workspace）的载体，可同时包含多个不相关的文件夹，并各自保留独立的设置和终端路径。
- 如果你有
backend/和frontend/两个文件夹，想一起打开并分别配置，必须用.code-workspace文件，code .没法做到 -
code .无法继承.code-workspace里定义的任务、launch.json 或推荐扩展列表 - 终端默认工作目录：对
code .是当前目录；对.code-workspace默认是第一个文件夹的根路径，除非你在settings.json里显式设了"terminal.integrated.cwd": "${workspaceFolder}"
启动后左侧空白？检查状态栏提示和路径末尾斜杠
即使 code 命令成功执行，也可能只弹出一个空编辑器窗口，资源管理器里什么都没有。这不是命令失败，而是 VS Code 没把目标识别为“已打开的文件夹/工作区”。最常被忽略的两个细节：
- 路径末尾带斜杠（如
code /path/to/project/）可能触发解析异常，导致只开窗口不加载——去掉结尾的/再试 - 目标路径是符号链接、网络盘（Z:）、或 UNC 路径（
\servershare）时，某些 VS Code 版本会静默降级为“无文件夹模式”，左下角显示No folder opened - 验证是否真加载成功：看左下角状态栏是否显示文件夹名或工作区名；没显示就说明只是空窗口，得关掉重来
code . 和 code xxx.code-workspace 是等价切换方式——它们底层加载机制、配置作用域、甚至终端起始目录都不同，混用会导致任务跑错目录、插件不生效、调试器找不到 launch.json。
