VSCode是编辑器,需单独安装工具链;命令未找到主因是PATH配置错误。在内置终端运行node -v等验证,macOS应终端启动code命令,Windows需设默认终端,Linux建议改~/.profile;核心扩展仅Python、Prettier、Remote-SSH等;settings.json推荐配置autoSave、formatOnSave及跨平台PATH补全。

VSCode 本身不需要“安装开发环境”,它只是一个编辑器;真正要装的是你写代码所需的工具链(比如 Python 解释器、Node.js、Go 编译器等),VSCode 只负责调用它们。装错位置或漏配 PATH,90% 的「命令未找到」问题就源于此。
怎么判断 VSCode 是否能正确调用终端命令?
打开 VSCode 内置终端(Ctrl+`),直接运行 node -v、python3 --version 或 go version。如果报 command not found,说明 VSCode 启动时没读到你的 shell 配置(比如 ~/.zshrc 或 ~/.bash_profile)。
常见原因和解决方法:
- macOS 下从 Dock 启动 VSCode,默认不加载 shell 环境变量 —— 改用终端启动:
code命令(需先执行code --install-extension ms-vscode.vscode-typescript-next安装 CLI 工具) - Windows 用户若用 Git Bash 或 WSL 终端,要在 VSCode 设置里指定默认终端:搜索
terminal.integrated.defaultProfile.windows,选对应 shell - Linux 某些桌面环境(如 GNOME)可能忽略
~/.bashrc—— 把环境变量写进~/.profile更稳妥
Extensions 装哪些才算“够用”?
别一上来搜“Python 插件推荐”全装一遍。真正影响体验的只有几个核心扩展,其余按需开启:
PHP网络编程技术详解由浅入深,全面、系统地介绍了PHP开发技术,并提供了大量实例,供读者实战演练。另外,笔者专门为本书录制了相应的配套教学视频,以帮助读者更好地学习本书内容。这些视频和书中的实例源代码一起收录于配书光盘中。本书共分4篇。第1篇是PHP准备篇,介绍了PHP的优势、开发环境及安装;第2篇是PHP基础篇,介绍了PHP中的常量与变量、运算符与表达式、流程控制以及函数;第3篇是进阶篇,介绍
-
Python(官方):提供调试、智能提示、格式化(依赖black或autopep8,需单独 pip install) -
Prettier:前端项目必备,但注意和 ESLint 冲突 —— 关闭prettier.eslintIntegration(已废弃),改用eslint.format.enable+eslint.packageManager -
Remote - SSH:想连服务器写代码?必须装。但首次连接会生成~/.ssh/config条目,别手误覆盖原有配置 -
Bracket Pair Colorizer 2(可选):嵌套括号太多时肉眼难分,但它在新版本 VSCode 中和原生括号高亮有重叠,建议关掉原生的editor.guides.bracketPairs
settings.json 里最该手动写的三行配置
图形界面点点点容易漏项,直接改 settings.json(Ctrl+, → 右上角 `{}` 图标)更可靠:
{
"files.autoSave": "onFocusChange",
"editor.formatOnSave": true,
"terminal.integrated.env.linux": { "PATH": "/home/you/.local/bin:/usr/local/bin:${env:PATH}" }
}说明:
-
files.autoSave设为onFocusChange比afterDelay更省心,切窗口即保存,不怕断电丢代码 -
editor.formatOnSave开启后,务必确认当前文件类型绑定了格式化工具(比如 Python 文件要装了Python扩展且python.formatting.provider设对) -
terminal.integrated.env.*是跨平台补PATH的唯一可靠方式,尤其当你把工具装在用户目录(如pipx、npm install -g)时,系统终端能找到,VSCode 终端却找不到
真正的难点从来不是“怎么点开设置”,而是搞清哪个进程(shell / VSCode / 扩展后台服务)在什么时候读了哪份环境变量。多试两次 echo $PATH 对比终端和 VSCode 内置终端输出,比看十篇教程都管用。









