在 macos 终端用 code 命令打开 vs code 项目需先执行 shell command: install 'code' command in path 并重启终端,再运行 code .(当前目录)、code ~/path 或 code "/path with spaces";可加 -n 新建窗口、-r 复用窗口、--goto 跳转行列。
在 macos 上用终端命令直接用 vs code 打开指定项目目录,核心就两步:确保 code 命令可用,再用它指向目标路径。只要配置正确,一行命令就能打开整个文件夹作为工作区,无需手动点选。
确认并安装 code 命令到系统 PATH
如果终端输入 code --version 没反应或报 command not found,说明 VS Code 的命令行工具还没注册进系统环境。这不是 VS Code 没装好,而是 shell 找不到它。
- 打开 VS Code,按 Cmd + Shift + P 调出命令面板
- 输入 Shell Command: Install 'code' command in PATH,回车执行
- 关闭并重新打开终端(这步不能跳过,尤其用 zsh 或 iTerm2 时)
- 再运行
code --version,有版本号输出即成功
用 code 命令打开项目目录的写法
路径必须准确,且推荐使用绝对路径或当前目录符号 .,避免歧义。
-
code .:在当前终端所在目录打开,最常用。确保你已cd进入目标项目根目录 -
code ~/Projects/my-app:用波浪号展开用户主目录,适合常用路径 -
code /Users/yourname/Desktop/my-project:完整绝对路径,最稳妥 -
code "My Project Folder":路径含空格时,必须用英文双引号包裹
打开行为控制(可选但实用)
默认 code . 会复用最近激活的窗口。如需调整行为,加参数即可:
-
code -n .:强制新建窗口,不复用已有实例 -
code -r .:强制复用当前活动窗口,不新开标签页 -
code --goto app.js:25:3:打开文件并直接跳转到第 25 行第 3 列
常见打不开的原因和检查点
如果执行后只弹出空编辑器,左下角显示 No folder opened,大概率不是命令错,而是路径或环境问题:
- 终端当前目录是否真的是你想打开的项目根目录?用
pwd确认 - 路径末尾有没有多余斜杠?比如
code ./project/容易触发解析异常,写成code ./project更稳 - 目标是否为符号链接或挂载的网络盘?部分 VS Code 版本对这类路径支持不完整
- 已有 VS Code 窗口正在运行,且设置了严格复用策略,新请求被静默忽略











