code命令无反应的根本原因是PATH未生效：Windows需检查是否勾选“添加到PATH”或手动添加bin路径，macOS/Linux须通过命令面板执行“Install 'code' command in PATH”并重启终端验证。
code 命令根本没反应？先确认 PATH 是否生效
装完 VS Code 却在终端里输入 code 报错“不是内部或外部命令”，大概率是安装时漏勾了“添加到 PATH”选项。这个选项只在 Windows 用户版（User Installer）安装过程中出现，系统版（System Installer）默认不写入当前用户 PATH。检查方法：打开 PowerShell 或 CMD，执行 echo %PATH%，搜索是否有类似 C:Users\AppDataLocalProgramsMicrosoft VS Codein 的路径。没有就只能重装，或者手动把该路径加进系统环境变量的 Path 里。
Windows 下用命令行直接打开文件/文件夹
code 命令的核心用途不是“安装”，而是启动编辑器并加载内容。它本质是 VS Code 安装目录下 bincode.cmd 的快捷入口，所以必须 PATH 正确才能用。
- 打开当前目录：
code . - 打开指定文件：
code main.py - 打开多个文件：
code index.html style.css script.js - 新建空白窗口（不加载任何文件夹）：
code -n - 强制新建窗口（即使已有实例在运行）：
code -n -r - 以只读模式打开：
code --read-only README.md
注意：-r 参数在 Windows 上有时被解释为“恢复会话”，真正要绕过已有窗口、强制新开一个，得用 code -n -r 组合；单独 -r 可能无效。
Mac 和 Linux 的 code 命令要手动软链
macOS 和 Linux 安装包默认不创建 code 命令，需要手动执行一次 Shell 脚本生成软链接。首次启动 VS Code 后，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Shell Command: Install 'code' command in PATH 并回车。VS Code 会自动在 /usr/local/bin/（Mac）或 /usr/bin/（Linux）下创建指向其内部二进制文件的软链接。
如果提示权限错误，说明你没用管理员权限运行 VS Code，或者目标目录不可写。此时可改用用户级路径：mkdir -p ~/bin && ln -s "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" ~/bin/code（Mac），然后把 ~/bin 加进 $PATH。
code 命令的隐藏参数会影响调试体验
开发中容易忽略的是 --disable-extensions 和 --user-data-dir 这两个参数。前者用于排除插件干扰，排查启动慢或崩溃问题；后者可指定独立配置目录，适合开多个隔离工作区（比如一个跑 Python，一个跑前端，互不污染扩展状态或设置缓存）。
- 禁用所有插件启动：
code --disable-extensions . - 用干净配置启动（不影响主配置）：
code --user-data-dir /tmp/vscode-test . - 配合调试器使用：
code --inspect-extensions=5858 .（启用扩展调试端口）
这些参数不会被 GUI 记住，每次都要显式传入。尤其 --user-data-dir 如果指向一个已存在的非空目录，VS Code 会直接报错退出——它要求该目录要么为空，要么是之前用同样参数创建过的合法数据目录。
实际用起来最常卡住的点，其实是 PATH 没生效就急着敲 code，或者在 Mac/Linux 上跳过了 Shell Command 初始化步骤。这两个地方一旦出问题，后面所有基于命令行的自动化流程（比如 Git commit hook 调用 code --wait 编辑提交信息）都会断掉。
