code命令在终端不可用是因为未注册到PATH,需通过VSCode的Shell Command命令安装;code .是启动项目的正确方式,确保加载项目配置;多项目应使用工作区而非多个窗口。

能直接用 code . 启动,但前提是命令已注册进系统 PATH;否则终端里敲 code 会报 command not found——这不是 VSCode 没装,而是 shell 根本找不到那个可执行文件。
code 命令为什么在终端里用不了
VSCode 安装包自带的 code 可执行文件默认不进系统 PATH,macOS 和 Linux 尤其明显;Windows 虽然安装时勾选 “Add to PATH” 可自动注册,但很多人没注意或权限不足导致失败。
- 验证方式:终端运行
code --version,无输出或报错即未就绪 - 唯一可靠修复动作:打开 VSCode 图形界面 →
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Win/Linux)→ 输入并执行Shell Command: Install 'code' command in PATH - 执行后必须新开终端窗口,旧终端不会自动加载更新后的 PATH
- 非官方安装方式(如 .zip 解压版、Snap、Flatpak)大概率不支持该命令,需换用官方 dmg/msi 包
code . 是最稳的项目启动方式,但参数顺序不能错
用 code . 打开当前目录,VSCode 才会把它当“项目根”,加载 .vscode/settings.json、launch.json、语言服务器上下文等。误点菜单里的「Open File」只会开单个文件,调试和符号跳转全失效。
-
code -r .:复用已有窗口(推荐日常使用),避免弹一堆窗口 -
code -n .:强制新开窗口(适合对比两个分支或不同环境) -
code -g app.js:42:3:打开文件并跳转到第 42 行第 3 列 - 参数必须写在路径前:
code -r .有效,code . -r会被忽略 - 路径含空格或中文?加双引号:
code "./my project"
多项目协作时别开多个独立窗口
用「将文件夹添加到工作区」比反复 code -n 更高效:共享终端、统一搜索、Git 面板聚合所有变更、调试器能跨项目设断点。
- 操作路径:资源管理器右键 →
将文件夹添加到工作区→ 选第二个项目目录 - 最后执行
文件 → 将工作区另存为生成.code-workspace文件 - 该文件存的是相对路径(如
"./backend"),不是绝对路径,适合 Git 提交和团队共享 - 临时加一个子模块(比如
packages/ui)?不用立刻保存 workspace,关掉再打开会自动恢复上一次结构
最容易被忽略的一点:VSCode 的“项目”没有隐藏初始化步骤,也不依赖 package.json 或 tsconfig.json;只要路径存在、权限正常、且你用的是 code . 或「Open Folder」,它就认这个目录为根——其他所有功能都基于此成立。











