code命令打不开是因为vs code的cli未注册到path，需在已运行的vs code中执行“shell command: install 'code' command in path”，然后重启终端验证code --version。

code 命令根本打不开？先确认是否注册进 PATH

终端输入 code --version 没输出，就别试打开文件了——code 命令压根没生效。这不是路径写错，而是 VS Code 的 CLI 工具未注入系统环境变量。

解决方式统一：在已运行的 VS Code 中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行：Shell Command: Install 'code' command in PATH。执行后必须关闭当前终端、新开一个，再验证 code --version。

• macOS 用户注意：VS Code 会往 ~/.zshrc 或 ~/.bash_profile 写入 export PATH 行；若手动改过 shell 配置，需确认该行确实存在且未被注释
• Linux（尤其是 Snap 版）：官方 tar.gz 包才自带 code；Snap 安装的版本不提供此命令，建议卸载后重装
• Windows：即使安装时勾选了 “Add to PATH”，重装或企业策略也可能覆盖，仍需走命令面板重新注册

打开单个文件：路径引号、空格、冒号都得小心

想用 code 直接打开一个文件，最简写法是 code index.html，但真实场景常踩坑：

• 路径含空格（如 My Project/app.js）：无需引号，code My Project/app.js 合法且有效
• 路径含 shell 特殊字符（如 $、*、(）：必须加双引号，例如 code "src/utils/test$helper.ts"
• 想跳转到具体行和列：必须用 -g 参数 + 引号包裹完整路径+位置，例如 code -g "src/main.ts:24:5"；漏掉 -g 或引号不全，VS Code 会当成普通文件名打开，定位失败
• 列号从 1 开始计数，不是 0 —— 和编辑器右下角显示的 Col 8 一致

打开文件夹 ≠ 打开文件：别用 Open File 当项目入口

用 code package.json 只会加载这个 JSON 文件，不会建立项目上下文。调试配置（launch.json）、工作区设置（settings.json）、语言服务识别根目录，全失效。

VSCode

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

下载

真正打开“项目”，必须指向文件夹：

• code .：只在你已 cd 进目标目录时才安全；否则它打开的是当前终端所在路径
• code /full/path/to/project：更可靠，尤其写脚本或远程操作时；Windows 推荐用正斜杠，如 code C:/dev/myapp
• 结尾带斜杠（如 code ./src/）可能触发解析异常，导致左侧资源管理器空白、状态栏显示 No folder opened
• 符号链接、网络盘（Z:）、UNC 路径（\servershare）支持不稳定，打开后空白大概率是这类路径问题

复用窗口还是新开？参数顺序决定行为

code 默认复用最近激活的窗口，但很多人不知道参数位置极其关键：

• code -r .：复用已有窗口，把当前目录加入工作区（-r 必须在路径前）
• code . -r：-r 被忽略，等效于 code .，行为不确定
• code --new-window /path：强制新开独立窗口；--new-window 不能省略，-n 是别名，但可读性差
• 临时查一个配置？直接 code .eslintrc.cjs 即可，不用加 -r，它不会干扰当前工作区

多项目协作时，“将文件夹添加到工作区”比开一堆窗口更高效——共享终端、统一搜索、Git 面板聚合所有变更。但记住：.code-workspace 里存的是相对路径（如 "./backend"），不是绝对路径，这点容易被忽略。