VSCode本身不运行代码，只调用系统已安装的Node.js、Python等工具执行；常见问题根源是环境变量未正确配置、工作区未信任、语言模式识别错误或运行时未安装。

VSCode 本身不运行代码，它只负责写和组织代码；真正执行代码的是你系统里装的 Node.js、Python 或 gcc 这类工具——这点没搞清，后面所有“为什么点不了运行”“终端报错找不到命令”问题都会反复出现。

下载 VSCode 前先确认系统路径不含中文

这是新手踩坑率最高的地方：把 VSCode 装在「桌面\编程学习」或「D:\软件\vscode」这类路径下，后续安装插件、调用终端、甚至保存文件都可能失败。Windows 用户务必选默认路径（如 C:\Users\用户名\AppData\Local\Programs\Microsoft VS Code），macOS 和 Linux 用户避免把工作文件夹建在「下载」或「文稿」这类系统默认中文命名目录里。

• 安装时勾选 Add to PATH（Windows）或执行 Shell Command: Install 'code' command in PATH（macOS/Linux），否则终端输 code . 会提示“command not found”
• 不要从第三方网站、网盘链接或“绿色版”渠道下载，只认准 code.visualstudio.com
• macOS 首次启动若弹出“无法验证开发者”，需手动去「系统设置 > 隐私与安全性」点“仍要打开”

新建文件夹 ≠ 新建项目，必须用“打开文件夹”

VSCode 没有“新建项目”按钮，它的最小工作单元是文件夹。直接双击打开一个空文件，编辑器会以“无工作区”模式运行，此时插件功能受限、配置无法持久化、Git 集成也失效。

VSCode

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

下载

• 在电脑任意位置新建一个纯英文命名的空文件夹，例如 hello-js 或 py-practice
• 启动 VSCode → 「文件」→ 「打开文件夹」→ 选中该文件夹
• 右键资源管理器空白处 → 「新建文件」→ 命名为 index.js 或 main.py，别用 test.txt 后缀，否则语言模式识别失败

运行代码前，必须确认对应运行时已安装且可用

写完 console.log("Hello") 却点不运行？不是 VSCode 的问题，而是你没装 Node.js；写好 print("Hello") 报错 python: command not found？说明 Python 没加进系统环境变量。

• 终端输入 node -v 或 python --version，能返回版本号才算就绪
• Windows 安装 Python 时务必勾选 Add Python to PATH；macOS 用 brew install python 更稳妥
• 不要依赖插件“一键运行”（比如 Code Runner），先学会在集成终端里手动敲 node index.js 或 python main.py，这样出错才能看懂真实错误来源

语言模式和自动保存是两个最该立刻配的基础项

右下角显示 Plain Text 却写 JavaScript？语法不会高亮，Ctrl+Space 也没提示。不设自动保存？改了十行代码，关掉窗口才发现没存。

• 点击右下角语言标识（如 Plain Text）→ 搜索并选择对应语言，例如 JavaScript、Python、C++
• 按 Ctrl+, 打开设置 → 搜索 files.autoSave → 设为 afterDelay（延时保存，比 onFocusChange 更可靠）
• 搜索 editor.formatOnSave 并启用，配合 Prettier 或内置格式化器，省去手动排版时间

实际动手时最容易卡在“以为装了就能跑”，结果连终端里 node 命令都不存在。与其反复重装 VSCode，不如花三分钟在终端里确认 node -v 和 code --version 都能正常输出——这两个命令能跑通，后面 90% 的入门问题都不会发生。