code 命令未注册 path 会导致所有操作静默失败；需通过 vs code 的 shell command 命令安装到 path（macos/windows）或换用 tar.gz 包（linux snap 版本）；path 更新后必须新开终端，且路径末尾斜杠、符号链接、unc 路径易致资源管理器空白。

code 命令根本没注册进 PATH，就别试打开文件夹了——终端输入 code --version 没输出，说明 code 这个命令压根不存在，后续所有路径操作都会静默失败或报 command not found。

怎么让终端认出 code 命令

不是重装 VS Code，而是让系统 PATH 知道它在哪：

• macOS：已运行 VS Code 时按 Cmd+Shift+P，输入并执行 Shell Command: Install 'code' command in PATH；完成后必须关掉当前终端，新开一个再验证
• Windows：已运行 VS Code 时按 Ctrl+Shift+P，同样执行该命令；若从未启用过，也可能是安装时没勾选 Add to PATH，重跑安装向导补上即可
• Linux（.deb/.rpm）：通常自动注册；若失效，优先检查是否用了 Snap 版本（它不提供 code），换成官网 tar.gz 包更稳妥

code . 和 code /path/to/folder 的实际区别

看似只差一个点，但行为差异直接影响脚本健壮性和日常使用体验：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• code .：只对当前终端工作目录有效；如果终端在 /home/user，却想开 /home/user/project，得先 cd project 再执行
• code /path/to/folder：推荐显式写绝对路径，不依赖当前位置；Windows 用正斜杠最省事，比如 code C:/dev/myapp
• 路径含空格无需引号（code C:/My Projects/app 合法），但含 $、* 等 shell 特殊字符必须加双引号
• 结尾多一个 /（如 code /project/）可能触发解析异常，导致左侧资源管理器空白、状态栏显示 No folder opened

打开后左边一片空白？不是命令失败，是没识别为工作区

命令成功执行了，但 VS Code 只弹了个空编辑器窗口——这说明它没把路径当作“已打开的文件夹”，只是启动了新实例：

• 检查左下角状态栏：显示 No folder opened 就是这个问题
• 常见诱因：路径是符号链接、网络盘（Z:）、UNC 路径（\servershare），某些版本支持不稳定
• 目标文件夹下没有 .git 或 package.json 不影响功能，只是 UI 提示弱化；VS Code 不靠这些文件判断是否可打开
• 临时补救：点菜单 File → Open Folder…；长期避免：确保路径真实、不带尾部斜杠、不用映射盘符

想强制新开窗口，别只输 code .

默认行为是复用最近激活的 VS Code 窗口。要干净的新窗口，参数不能省：

• code --new-window .：当前目录开新窗口（点号 . 不可省）
• code -r /path/to/project：复用已有窗口，把该目录作为新工作区（只对目录有效）
• code -n /path/to/project：强制新建窗口，不管有没有已有实例

最容易被忽略的是：PATH 更新后必须新开终端，以及路径末尾的斜杠和符号链接问题——它们不会导致命令报错，但会让 VS Code “假装打开了”，实则资源管理器一片空白。