code命令非自动可用，需安装时勾选“add to path”或手动注册：windows添加bin路径到环境变量并重启终端，macos通过命令面板执行shell command安装，linux需确认deb包安装及path包含/usr/bin。
VSCode 的 code 命令不是装完就自动可用的，必须在安装时勾选「添加到 PATH」，或手动执行注册命令，否则终端里输入 code 会报 command not found。
Windows 安装时没勾选“Add to PATH”，怎么补救
很多人装完才发现 code 命令用不了，不是重装，而是路径没注册。User Installer 默认装在 C:\Users\{用户名}\AppData\Local\Programs\Microsoft VSCode\，System Installer 则可能在 C:\Program Files\Microsoft VSCode\。你得先确认安装位置，再把 bin 子目录加进系统 PATH。
- 打开文件资源管理器，进入 VSCode 安装目录，检查是否存在
bin文件夹（新版 VSCode 已将code.cmd放在此处） - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”或“用户变量”的
Path中新增一行：C:\Users\{用户名}\AppData\Local\Programs\Microsoft VSCode\bin - 重启终端（CMD/PowerShell/Terminal），运行
code --version验证
macOS 终端里 code 命令无效的常见原因
macOS 上 code 命令依赖 shell command 扩展注册，它本质是往 /usr/local/bin 写一个指向 VSCode 内部脚本的软链接。这个动作必须由 VSCode 主进程触发，且当前 shell 配置要能识别该路径。
- 确保 VSCode 是从 Applications 文件夹启动的（而不是双击 .app 包内可执行文件），否则权限不足无法写入
/usr/local/bin - 启动 VSCode 后按
Cmd+Shift+P，输入shell command，选择Shell Command: Install 'code' command in PATH - 如果提示权限错误，检查终端是否使用 zsh（默认）；若用 bash，需确认
~/.bash_profile或~/.zshrc是否已 source/usr/local/bin - 执行
which code看是否返回/usr/local/bin/code，否则需手动sudo ln -sf "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" /usr/local/bin/code
Linux 下 code 命令不生效，别只信 dpkg -i
Debian/Ubuntu 用户用 sudo dpkg -i code_*.deb 装完，code 命令仍不可用，是因为 deb 包默认不注册 shell command —— 它只把二进制放在 /usr/bin/code，但该路径可能未被 shell 加载，或被其他同名命令覆盖。
- 先运行
ls -l /usr/bin/code确认文件存在且有执行权限 - 检查当前 shell 的
$PATH是否包含/usr/bin（通常默认包含，但某些最小化系统会删掉） - 运行
code --version测试；若失败但/usr/bin/code --version成功，说明 PATH 有问题，临时修复：export PATH="/usr/bin:$PATH" - 永久修复：把
export PATH="/usr/bin:$PATH"加到~/.bashrc或~/.zshrc，然后source它
用 code 命令打开项目时容易忽略的路径细节
code 命令对路径敏感，尤其涉及空格、中文、相对路径和符号链接时，行为可能不符合直觉。
- 路径含空格必须用引号包裹：
code "My Project"，否则只会打开My文件夹 - 中文路径在 Windows CMD 下可能乱码，建议改用 PowerShell 或 Windows Terminal；macOS/Linux 一般无问题
-
code .是常用操作，但若当前目录是软链接，VSCode 默认解析为真实路径 —— 这会影响后续 Git、调试器路径匹配 - 想强制以当前 shell 路径为准（不解析 symlink），可用
code --no-sandbox .（仅调试用，非推荐） - 远程开发（SSH/WSL）场景下，
code必须在目标环境中已安装并注册，本地终端执行code不会自动转发
PATH 注册和路径解析这两个环节，看似基础，却是多数人反复卡住的地方。特别是跨平台协作时，同一份文档里写的 code .，在队友 Mac 上成功，在你 Windows CMD 里报错，问题往往不出在 VSCode 本身，而在于 shell 环境与安装路径的隐式耦合。
