VS Code 的 code 命令无响应是因 PATH 未生效或未启用命令行支持;macOS/Linux 需在已打开窗口中运行 Shell Command: Install 'code',Windows 需重装并勾选“Add to PATH”或手动添加 bin 目录;WSL 用户须用 Remote - WSL 扩展;修改 PATH 后必须关闭所有终端并新开窗口;code . 默认复用窗口,需显式加 --new-window 参数才能新建窗口;路径含空格或中文时 PowerShell 中建议加双引号;UNC 路径支持不稳定;带 Conda 环境启动需在同进程执行 conda activate && code --new-window .。

code 命令根本没反应?不是装错了,是 PATH 没生效 —— 这一步卡住,后面全白搭。
code --version 无输出,说明 CLI 根本没注册
终端里输 code --version 没任何返回,甚至报 command not found: code,这不是路径写错或权限问题,而是 VS Code 的命令行支持压根没启用。
- macOS/Linux:必须在已打开的 VS Code 窗口中按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Linux),输入并运行Shell Command: Install 'code' command in PATH - Windows:安装时没勾选 “Add to PATH”,就得重装并勾选;若已安装,手动把
C:Users{user}AppDataLocalProgramsMicrosoft VS Codein加进系统环境变量 - WSL 用户注意:
code是 Windows 主机命令,在 WSL 里直接调用会失败,得用 Remote - WSL 扩展 - 执行完必须关掉所有终端窗口,新开一个再试 —— 已有终端不会自动加载新 PATH
code . 总在旧窗口打开,是因为没加 --new-window
code . 默认复用已有窗口,这是设计行为,不是 bug。要真正启动新窗口,参数不能省。
- 正确写法只有这一种:
code --new-window .(--new-window不可缩写为-n在某些旧版本可能不识别,建议写全) - 点号
.表示当前目录,也不能省;留空或只写code会打开空白窗口 - 路径末尾多加斜杠(如
code ./或code /path/)可能导致资源管理器为空,但窗口正常弹出 - 符号链接目录会被原样加载,VS Code 不自动解析为真实路径,有时导致 “No folder opened” 提示
路径含空格、中文或特殊字符,要不要加引号?
截至 2026 年 10 月,VS Code 自己做了路径容错处理,绝大多数情况不需要引号。
- Windows 上推荐用正斜杠:
code C:/My Projects/app合法;若用反斜杠,必须双写:code C:\My Projects\app - macOS/Linux 下
code ~/My Projects/app可直接运行,无需引号 - 但 Windows PowerShell 中若路径含中文或空格,偶尔会因 shell 解析异常失败,此时加双引号更稳:
code ".my project" - UNC 路径(如
\servershare)和网络驱动器(如Z:)支持不稳定,尽量映射为本地路径再用code
带 Conda 环境启动 VS Code,避免 Python 解释器错乱
VS Code 不继承终端的 conda 激活状态,直接 code . 很可能让 Python 插件选错解释器。
- 先激活环境,再启动编辑器:
conda activate my_env && code --new-window . - 确保
my_env中已安装python和ipykernel,否则 VS Code 无法识别该环境 - 不要
code .启动后再手动切换解释器 —— 有时插件缓存不刷新,得重启窗口才生效 - 命令必须在同一个 shell 进程中完成,写成两行(先
conda activate,再另起一行code)会失效
最常被忽略的是 PATH 生效时机和 --new-window 的强制性 —— 其他都可绕过,这两点不处理,就永远在“以为启动了”和“其实没打开项目”之间反复横跳。











