VSCode入门教程：如何快速安装与配置开发环境？【教程】

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 插件推荐”全装一遍。真正影响体验的只有几个核心扩展，其余按需开启：

• 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 内置终端输出，比看十篇教程都管用。