VS Code需先打开文件夹才能正常工作,否则功能如搜索、构建、插件均失效;终端不自动运行代码,F5需配置launch.json;插件依赖工作区和语言模式;设置分用户级和工作区级。

打开文件夹后没反应?确认工作区已加载
VS Code 不是双击就“启动即用”的编辑器,它默认打开的是空界面。你必须先通过 File → Open Folder... 选中一个真实存在的项目文件夹(比如 my-project),才能看到左侧资源管理器里出现文件列表、右键有操作选项、终端能识别当前路径。
常见错误现象:Ctrl+P 搜索不到文件、Ctrl+Shift+B 找不到构建任务、扩展(如 Python)提示“未在工作区激活”——基本都是因为还没打开文件夹,只打开了单个文件或空白窗口。
- 不要双击
.py或.js文件直接打开,那只是临时标签页,不是工作区 - 首次使用建议新建一个测试文件夹(如
~/vscode-test),放一个hello.txt,再用Open Folder加载它 - 关闭 VS Code 后重新打开,它会自动恢复上次的文件夹——这个行为可关闭:设置里搜
restoreWindows,设为none
代码写完了却不会运行?终端和运行方式要分清
VS Code 自带集成终端(Ctrl+`),但它只是命令行窗口,不会自动执行你的代码。运行 Python、Node.js 等脚本,得自己输命令,比如 python main.py 或 node index.js。别指望按 F5 就能跑通——那需要提前配好调试配置(.vscode/launch.json)。
新手最容易卡在这一步:写了 print("hi"),点了 F5,弹出“请先选择环境”,然后懵了。
- 快速验证代码:按
Ctrl+`呼出终端 → 确认路径正确(pwd)→ 输入对应命令(python3 script.py) - 不想记命令?右键文件 →
Run Code(需装扩展 Code Runner);但注意它默认不读取当前终端环境变量 -
F5是调试专用,首次使用前必须点run and debug → create a launch.json file,选语言再生成配置
插件装了但不生效?检查是否在工作区启用
很多插件(如 Prettier、ESLint、Python)默认只在“支持该语言的文件夹”中激活。如果你打开的是空文件夹,或文件没保存(还是 Untitled-1),插件图标灰着、格式化快捷键没反应,都是正常现象。
关键判断点:看左下角状态栏——那里会显示当前语言模式(如 Plain Text)、编码、换行符。如果它没变成 Python 或 JavaScript,插件大概率不会介入。
- 手动切换语言模式:
Ctrl+Shift+P→ 输入Change Language Mode→ 选对应语言(如Python) - 保存文件(
Ctrl+S),后缀名必须匹配(.py、.js),否则语言服务不启动 - 部分插件需重启窗口才生效(尤其是涉及语法高亮或 LSP 的),右键标题栏 →
Developer: Restart Extension Host
设置改了没效果?优先查用户设置 vs 工作区设置
VS Code 有两层设置:全局(User)和当前文件夹专属(Workspace)。比如你在某个项目里关掉了自动保存(files.autoSave),结果发现其他项目也没保存了——大概率你误改了 User 设置,而不是 Workspace 设置。
工作区设置存在当前文件夹下的 .vscode/settings.json,它会覆盖 User 设置,且只对这个项目生效。这是协作和项目定制的关键机制,但新手常忽略。
- 修改设置时,右上角留意切换按钮:“User” 还是 “Workspace”
- 想让某项目禁用某个插件?在 Workspace 设置里加
"extensions.ignoreRecommendations": true - 字体太小?搜
editor.fontSize,改完记得看右下角是否实时生效;若无效,可能是主题或缩放级别(window.zoomLevel)在干扰










