code命令不存在或提示“command not found”是因vscode未注册到系统path；macos需通过cmd+shift+p运行shell command: install 'code' command in path，windows重装时勾选add to path，linux应使用官方.deb包安装。
code 命令不存在或提示“command not found”
这是最常见问题：VSCode 安装后默认不把 code 命令加入系统 PATH。macOS 和 Windows（通过 VSCode GUI 安装）都需要手动启用该功能；Linux 通常需从命令行安装包（如 .deb 或 .rpm）才自带 code。
解决方法：
- macOS：打开 VSCode → 左下角齿轮图标 → Command Palette（
Cmd+Shift+P）→ 输入并选择Shell Command: Install 'code' command in PATH，重启终端生效 - Windows：重装 VSCode 时勾选
Add to PATH；或在已安装情况下，用管理员权限运行 VSCode，再执行同名命令（路径为Shell Command: Install 'code' command in PATH） - Linux（Debian/Ubuntu）：确保用官方
.deb包安装，code会自动注册；若用 Snap 版本，则命令为code --no-sandbox（因权限限制），且部分终端可能无法识别
code 启动项目但文件没打开或工作区异常
code 后跟路径时，行为取决于路径类型和当前状态：
- 传入单个文件（如
code index.js）：直接打开该文件，工作区为空 - 传入文件夹（如
code ./my-project）：以该文件夹为根启动工作区；若该目录含.vscode/settings.json或my-project.code-workspace，会自动加载配置 - 传入空参数（
code）：打开最近的文件夹或空窗口，取决于设置中的workbench.startupEditor - 若项目中已有未保存修改，
code重新启动时不会自动恢复——除非开启files.hotExit（默认开启）且退出方式是关闭窗口而非杀进程
code 常用参数与实际用途差异
几个高频但易误解的参数：
-
code -r（reuse window）：强制复用已有窗口打开新文件夹；不加此参数时，VSCode 默认对每个新文件夹开新窗口（Windows/macOS 行为一致） -
code -n（new window）：总是新开独立窗口，适合对比两个不同项目 -
code -w（wait）：终端会阻塞，直到编辑器窗口关闭；常用于脚本中，例如code -w . && git add . && git commit -
code --diff file1 file2：直接进入比较模式，无需先打开任一文件；注意顺序影响左/右面板布局
参数可组合使用，比如 code -r -n ./src 会新建窗口但复用已有窗口逻辑（实际效果等价于 -n，-r 被忽略）——参数冲突时以最后出现为准。
Windows 下 code 命令卡住或无响应
常见于 PowerShell 或 Git Bash 中，本质是 shell 无法正确解析 VSCode 注册的批处理包装器（code.cmd）。
- PowerShell：默认禁止执行本地脚本，报错类似
code : The term 'code' is not recognized或执行后立即退出；运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser可解 - Git Bash：
code是 Windows 批处理文件，Bash 无法直接调用；改用cmd //c code或配置别名alias code='cmd //c code' - WSL：不能直接调用 Windows 版
code；必须安装 VS Code Server 并用code（来自 WSL 内部安装）或通过code-insiders连接远程
真正容易被忽略的是：即使 code --version 成功返回，也不代表图形界面一定能弹出——它可能卡在后台等待 DISPLAY 或 GUI 权限，尤其在远程 SSH 或容器环境中。
