code命令失效的根本原因是注册失败或安装方式不兼容：Windows需检查PATH是否含bin目录，macOS确认/usr/local/bin/code是否存在，Linux Snap版默认不可用；必须通过GUI触发Shell Command注册并重启终端验证。
VSCode 的 code 命令失效，不是路径没加对就是注册根本没成功——它不会“半生效”，要么能用，要么完全找不到命令。
确认 code 命令是否真的注册了
很多人以为点过一次“Install 'code' command in PATH”就万事大吉，其实它只对当前用户、当前 Shell 会话生效，且依赖 VS Code 官方安装包里的包装器脚本。非官方版本（比如 .zip 解压版、Snap 包、Mac 上的 dmg 拖拽安装但没运行 installer）压根不支持这个命令。
- 在终端里直接运行
code --version，如果提示command not found，说明注册失败或未执行 - Windows 用户检查环境变量
PATH是否包含C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin - macOS 用户确认
/usr/local/bin/code是否存在，且指向/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code - Linux（如 Ubuntu Snap 版）
code命令默认不可用，得换 deb 包或手动软链
重装注册：必须图形界面触发 + 重启终端
别在终端里反复试 code，先确保 VS Code 图形界面已打开，再走注册流程——这是唯一可靠路径。
- 打开 VS Code GUI，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行
Shell Command: Install 'code' command in PATH - 关闭所有终端窗口（不是关标签页，是整个 Terminal 应用），再新开一个
- 此时
code --version才可能返回版本号；若仍失败，说明你用的是不支持该功能的安装方式
Windows 下 code . 一闪而过？检查路径和权限
命令能识别，但执行 code . 后窗口闪退，大概率是工作目录异常、中文路径未引号包裹，或杀毒软件拦截了子进程启动。
- 路径含空格或中文时，必须用双引号：
code ".\my project"或code "D:\我的项目" - 以管理员身份运行终端再试一次，排除 UAC 或策略组限制
- 临时禁用 Windows Defender 实时保护，看是否恢复——某些企业策略会静默阻止 VS Code 启动子终端进程
- 若仅在 PowerShell 中失效，尝试切换到 CMD 运行
code .，反向验证是否是 PS 模块或执行策略（Get-ExecutionPolicy）导致
macOS 上 Dock 启动正常，但终端不行？别混淆启动逻辑
macOS 点 Dock 图标能恢复窗口，不代表 code . 就该恢复——这是两个完全独立的启动路径。前者读 workspaces.json，后者强制新建工作区，window.restoreWindows 对它无效。
-
code .的行为永远是“打开当前文件夹为新工作区”，这是设计，不是 bug - 想复用已有窗口并触发恢复逻辑，必须加
-r参数：code -r . - 如果
code -r .仍不恢复，说明window.restoreWindows被设成了"none"或false，且该设置只在 User Settings 里有效 - 彻底退出 VS Code（
Cmd+Q），再运行code -r .，否则后台进程会干扰冷启动恢复流程
最常被忽略的一点：code 命令本身不读取 VS Code 设置，它只是个启动器；真正决定“开什么、怎么开”的，是 window.restoreWindows 和启动参数的组合。注册失败、路径错误、权限拦截、安装方式不兼容——这四类问题占了 90% 以上的实际案例，而不是配置写错了某一行 JSON。
