code命令不存在需先注册到PATH:macOS通过菜单安装,Windows安装时勾选Add to PATH或手动运行code.cmd,Linux用.deb/.rpm包自动注册;--folder-uri等参数已废弃,正确用法为code路径、-g行号跳转、--new开新窗口、WSL中用wslpath转换路径,PowerShell中路径需加引号,关键操作须加--wait确保就绪。

code 命令不存在?先确认 VSCode 已注册到系统 PATH
在终端输入 code 报错 command not found,说明 VSCode 没有把自身注册进系统环境变量。这不是安装失败,而是默认不自动注册。
- macOS:打开 VSCode → 从菜单栏选择 Code → Install 'code' command in PATH,完成后重启终端
- Windows:安装时勾选 Add to PATH;若已安装,重装并勾选,或手动运行 VSCode 安装目录下的
resources\app\bin\code.cmd(需以管理员身份运行) - Linux:官方 .deb/.rpm 包会自动注册;如用 tar.gz 手动解压,需将
bin/code软链接到/usr/local/bin/或加入$PATH
code --folder-uri 和 --file-uri 不是常规用法,别乱试
code 命令不支持 --folder-uri 或 --file-uri 这类参数——它们是内部调试接口,未公开,且在 1.89+ 版本中已被移除或拒绝响应。强行使用只会静默失败或报 Unknown argument 错误。
- 正确打开文件夹:直接
code /path/to/project - 正确打开单个文件:直接
code /path/to/script.py - 要带行号跳转:用
code -g /path/to/file:42:5(注意是-g,不是--goto,后者不被识别) - 多文件同时打开:
code file1.js file2.py,会按顺序在编辑器中打开标签页
想开多个独立窗口?必须加 --new 参数
默认情况下,code /another/folder 会复用已有 VSCode 窗口(哪怕它正在编辑其他项目),这容易造成工作区混乱。要强制新开一个干净窗口,必须显式传参:
-
code --new /path/to/second-project:启动全新窗口,不继承原窗口的扩展启用状态、终端、调试会话 -
code --reuse-window /path/to/project:显式要求复用(和默认行为一致,但更明确) - 不加
--new时,即使关闭了所有标签页,VSCode 仍可能把新路径加载进旧窗口的工作区树中,导致.vscode/settings.json冲突
WSL 下用 code 命令打开 Windows 文件?路径转换要小心
在 WSL 终端里执行 code /mnt/c/Users/me/project 可能卡住或打开空白窗口——因为 VSCode for Windows 无法直接解析 WSL 的挂载路径语义。
- 正确做法:在 WSL 中改用
code /home/me/project(前提是该目录已通过 VSCode Remote - WSL 扩展打开过) - 若坚持本地 Windows VSCode 打开 WSL 路径,需先用
wslpath -w /home/me/project转成 Windows 格式,再传给code,例如:code "$(wslpath -w /home/me/project)" - PowerShell 用户注意:
code在 PowerShell 中对含空格路径支持较差,建议用 CMD 或显式加引号:code "C:\My Project"
最易被忽略的一点:VSCode 启动后是否真正“就绪”——code 命令返回 shell 提示符不代表编辑器已完成初始化。如果后续脚本依赖编辑器 API(比如调用 code --wait 后续操作),务必加 --wait 参数,否则大概率读不到你刚保存的文件变更。


















