讲师中心 微信公众号
AI工具推荐 视频效率加速

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

云芳吖_7909

云芳吖_7909

发布时间:2026-01-20 20:41:34

|

719人浏览过

|

来源于php中文网

原创

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

vscode入门教程:如何快速安装与配置开发环境?【教程】

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

Conventional Git
Conventional Git

Conventional Commits v1.0.0 分支、工作树命名及提交信息规范,适用于 GitHub 与 GitLab 项目,用于创建分支和命名工作树等场景。

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

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

252

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

480

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

311

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

246

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

478

2026.06.16

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1975

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2722

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

936

2023.10.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn