找到
4
篇与
软件安装
相关的结果
-
【VS Code】告别安装与配置困难:新手保姆级指南 引言 Visual Studio Code(VS Code)是微软出品的跨平台代码编辑器,免费,且基于开源的 Code - OSS 项目构建;官方发行版带少量微软定制与许可条款(因此更准确的说法是“Built on open source”而非“完全开源”)。对第一次打开它的新手来说,界面与设置可能有些陌生。这篇超全新手指南会手把手带你完成 VS Code 的下载安装、中文界面设置、基本界面速览、常用插件与美化 等,让你快速上手。我们主要以 Windows 为示范(会注明 macOS 的差异),并在文末提供常见问题排障。 好了,开工! 一、下载安装 VSCode 首先,我们需要获取 VSCode 的安装程序。VSCode 支持 Windows、macOS 和 Linux 等操作系统。本节将以 Windows 系统为例演示下载安装流程,也会给出 macOS 与 Linux 的要点。 1. 从官网下载 VSCode 访问官方页面:打开浏览器进入 VS Code 下载页:https://code.visualstudio.com/Download。页面会自动识别你的系统并给出对应下载按钮(Windows 会显示 “Download for Windows”,macOS 会显示 “Download for macOS”)。 选择合适的安装包: Windows:推荐下载 User Installer(用户安装版) 的 .exe 安装程序(支持后台自动更新,无需管理员权限;System Installer 则面向所有用户安装,但更新体验略逊)。也可选择 ZIP 绿色版(不写注册表、不支持自动更新)。 macOS:下载 .zip,解压得到 Visual Studio Code.app。 Linux:提供 .deb、.rpm 等包,或使用 Snap / 官方 apt 仓库 安装(见下方 Linux 提示) 下载完成:在下载目录找到安装文件(Windows 为 .exe)。文件体积几十 MB。 2. 安装 VSCode Windows 运行安装程序:双击下载的 VSCode 安装文件(例如 VSCodeUserSetup-x64-版本号.exe),开始安装。首次运行可能会弹出安全提示,选择“运行”即可。 接受许可协议:在安装向导出现后,首先会显示一份许可协议(License Agreement)。勾选“我接受协议(I accept the agreement)”,然后点击 “下一步 (Next)” 继续。 选择安装路径: 接下来,安装向导会询问 VSCode 的安装目录。一般情况下使用默认路径即可,若不想占用系统盘空间,也可以点击“浏览”选择自定义路径。选定后,点击 “下一步”。 image.png|800图片 选择开始菜单文件夹: 通常直接保持默认,无需更改,继续 “下一步”。 选择附加任务: 这一步会提供一些额外选项的复选框,建议全部勾选(如:“创建桌面图标”、“将 VS Code 添加到 PATH(环境变量)”、“在文件资源管理器添加‘用 Code 打开’选项”等)。勾选后点击 “下一步”。勾选这些选项可以方便日后使用:例如添加到 PATH 后,可以在终端中直接使用 code 命令打开 VSCode。 image.png|800图片 准备安装: 确认之前的设置无误后,点击 “安装 (Install)”。安装程序将开始将 VSCode 文件复制到你的电脑中。此过程大约持续几十秒到一两分钟。 完成安装: 出现“完成安装 (Setup Completed)”界面时,勾选“Launch Visual Studio Code(启动 VSCode)”或直接点击“完成 (Finish)”即可结束安装并首次启动 VSCode。 macOS 安装 解压下载的 .zip 得到 Visual Studio Code.app,将其拖动到“Applications(应用程序)”即可完成安装。首次打开如遇“来自互联网下载的应用”提示,选择“打开”。若希望在终端中用 code 命令启动 VS Code,请在 VS Code 命令面板(⇧⌘P)执行:Shell Command: Install 'code' command in PATH。 Linux 安装提示 常见选择有两种: Snap(一步到位) sudo snap install --classic code(适合 Ubuntu 等已启用 Snap 的发行版) 官方 apt 仓库(随系统更新) 以 Ubuntu 22.04/24.04 为例:添加微软 GPG 密钥与仓库后安装 code 包(可随 apt 升级): # 导入微软 GPG 密钥(示例做法,依你的发行版文档更新) wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg # 添加 VS Code 仓库 sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' # 安装 sudo apt update sudo apt install code(优点:由系统包管理器自动处理更新) 现在,VSCode 已成功安装在你的电脑上啦!🎉 接下来,我们将进行一些初始配置,首先就是把界面切换为中文,更方便新手使用。 二、将 VSCode 切换为中文界面 微软官方提供了简体中文语言包扩展: 打开扩展商店:左侧点击 Extensions(或 Ctrl+Shift+X / ⇧⌘X)。 搜索并安装:输入 Chinese,选择 Chinese (Simplified) Language Pack for Visual Studio Code(发布者 Microsoft),点击 Install。 重启生效:安装后 VS Code 会提示“是否切换语言并重启”,点击 Restart。若错过提示,可在命令面板(Ctrl+Shift+P / ⇧⌘P)执行 Configure Display Language(配置显示语言),选择 zh-cn 并重启。 image.png|800图片 编者注(语言切换的两个入口): 命令:Configure Display Language; 配置文件:历史版本会在用户目录生成 locale.json(设定 "locale": "zh-cn"),新版以命令与语言包为主。 重启后,VS Code 即为中文界面:菜单、侧边栏、设置项等均显示为简体中文。 初次打开 VS Code,建议先认识它的五大区域:活动栏(最左列图标)、侧边栏(功能内容)、编辑区(中间写代码)、面板区(底部“终端/问题/输出/调试控制台”)、状态栏(底部信息栏)。点击不同图标即可在侧边栏切换文件、搜索、源代码管理(Git)、运行与调试、扩展等。底部面板可用快捷键 Ctrl+` 打开集成终端,在编辑器内直接运行命令;再按一次即可折叠。状态栏展示当前分支、编码(UTF-8)、行尾(CRLF/LF)、语言模式等,均可点击切换。 序号区域名称在截图中的位置与样子主要作用1活动栏 Activity Bar最左侧窄竖条,上下排列有「资源管理器」「搜索」「源代码管理」「运行调试」「扩展」等图标切换各大功能视图2侧边栏 Side Bar活动栏右侧、显示文件树的宽列(图中列出了 .claude、.venv、scripts/、使用说明.html 等)展示并操作当前功能的具体内容(此处是资源管理器中文件/文件夹列表)3编辑区 Editor居中最大区域,当前打开 使用说明.html 源码编写、查看与比较文件4面板区 Panel位于窗口底部;收起时只见左下角有 “问题” 标签(若按 Ctrl + ` 或点击标签即可展开终端/问题/输出/调试控制台面板)终端、调试、输出、问题等工具集中显示5状态栏 Status Bar最底部整条蓝色横栏,右侧显示 “UTF-8”、“LF”、“HTML” 等信息显示并快速切换分支、编码、行尾、语言模式及扩展状态image.png图片 四、安装常用插件、切换主题,美化你的编辑器 什么是插件? 插件(扩展)是VSCode功能的补充包,由官方或社区开发者提供。通过安装插件,可以为VSCode添加对某种编程语言的支持、增加代码片段、代码格式化、版本控制增强、界面主题图标等等功能。简单来说,插件就是“功力强化道具”,按需选择能大大提高你的开发体验。下面,我们按照插件安装 -> 主题更换 -> 图标更换的顺序,一步步来: 4.1 VSCode 插件推荐(新手通用) 先为大家列出几款通用且实用的 VSCode 插件。这些插件不针对特定编程语言,而是几乎所有人都会受益,对新手来说安装后马上能见效: 🏷 Chinese (Simplified) Language Pack(简体中文语言包) – (你已安装) 功能:将 VSCode 界面汉化。 说明:这就是我们刚才安装的中文界面包,新手必备,就不多介绍啦。如果日后想切换回英文,只需禁用或卸载此扩展,VSCode 会恢复英文界面。 ☀️ GitHub Light Theme(亮色主题) 功能:提供清爽护眼的亮色配色(含高对比与色盲友好方案)。 说明:安装后可在「设置 → 主题」里选择 GitHub Light Default / High Contrast / Colorblind 等多款亮色主题,整体观感统一、对文档与白底网页更友好,适合白天或投屏场景使用。 💄 One Dark Pro(经典暗色主题) 功能:提供一个好看护眼的编辑器配色主题。 说明:One Dark Pro 是 VSCode 上下载量最多的主题之一,深色风格简洁大方,长时间编程也不刺眼。安装后你的代码配色会变成酷酷的 Atom One Dark 风格。非常推荐喜欢暗色界面的同学尝试! 🧠 Claude Code for VS Code(Claude 代码助手扩展) 功能:把终端里的 Claude Code 能力“接上 VS Code”,支持选区上下文、内置 Diff 视图、标签页感知、快捷键把选中代码送入对话等。 说明:这是官方扩展,但需要先安装 Claude Code CLI(npm i -g @anthropic-ai/claude-code,在 VS Code 终端运行 claude 会自动检测/安装扩展)。适合长上下文理解与大范围重构/解释代码。 🧩 Cline(自主编码代理 / AI Coding Agent) 功能:在 VS Code 里以“代理(Agent)”方式协作开发:读/改文件、运行终端命令、搜索分析代码、用内置浏览器做检索/调试,并支持 MCP(Model Context Protocol) 扩展更多工具。所有动作默认逐步征求你的许可。 说明:Cline 是开源、本地优先、自带密钥(BYOK)的方案:代码不经其服务器、用你自己的模型密钥,成本与安全更可控;还提供 Plan / Act 两种模式: 1.Plan:只读代码库、梳理需求与实现策略,不直接改文件; 2. Act:按计划逐步执行(创建/修改文件、跑命令等),每一步都可审核;也可用“Auto-Approve”为特定动作设置细粒度的自动批准。 🎨 Material Icon Theme(文件图标主题) 功能:美化左侧资源管理器里的文件/文件夹图标。 说明:装了这个插件后,你会发现不同类型的文件有了五颜六色的图标,比如JS文件有JS的黄蓝图标,图片文件有小图片图标,文件夹也有特殊图标等。Material Icon Theme 是 VSCode 最受欢迎的图标主题之一,采用了谷歌 Material Design 风格,让文件列表更加直观美观。美化界面就靠它啦! ✅ Prettier - Code Formatter(代码格式化工具) 功能:自动规范你的代码格式。 说明:Prettier 可以根据预设规则自动调整代码的排版,如缩进、引号、分号等,使代码风格统一整洁。它支持多种语言(JS、TS、JSON、HTML、CSS 等等),尤其适合初学者防止代码格式混乱。当你写完代码按下保存时,Prettier 会自动帮你排版好(需稍作配置后实现自动保存格式化)。有了它,再也不用纠结代码缩进对不齐了! 🔍 GitLens – Git supercharged (Git 能力强化) 功能:增强 VSCode 内置的 Git 版本控制功能。 说明:如果你会使用 Git 来管理代码,GitLens 简直是神器。它可以在编辑区直接显示每行代码的最后修改者和时间,方便追踪更改;提供详细的提交历史浏览、分支对比、图形化视图等,让源码管理一目了然。即使你现在还是新手,不懂 Git 也没关系,但装上 GitLens 以备后用也是不错的选择。 🚀 Live Server(本地实时服务器) 功能:为静态网页提供实时预览功能。 说明:如果你编写 HTML/CSS/JS 页面,这个插件可以让你一键启动本地服务器,在浏览器中实时查看页面效果。当你保存文件时,页面会自动刷新显示新修改,开发网页就像“所见即所得”一样方便。大大提高前端开发效率。打算学做网页的新手强烈推荐安装! 💡 Better Comments(更好注释) 功能:让代码注释呈现不同颜色和样式。 说明:Better Comments 通过对注释文字加特殊前缀(如 // !、// ? 等),将其渲染成不同颜色的高亮效果,以区分重要提示、问题、警告等类型的注释。有了它,你在代码里写下 TODO、BUG、!NOTE 等注释会更醒目,方便日后快速定位。对写代码习惯做笔记的人来说很实用。以上只是冰山一角 🌟。VSCode 插件市场中还有数以千计的扩展,可满足各种需求(如Markdown支持、各类语言插件、Docker工具、远程开发等等)。但初学者不必一下装太多,保持精简很重要。建议先从上面列出的几个开始体验,日后根据需要再探索新的插件。 4.2 如何安装插件? 在前面安装中文语言包的过程中,其实我们已经学会了插件的安装方法:通过 VSCode 左侧的扩展(插件)视图搜索并一键安装。回顾一下: 点击左侧活动栏的 扩展 图标,打开扩展商店面板(或使用快捷键 Ctrl+Shift+X)。 在上方搜索框输入插件名称关键字,例如 “_One Dark Pro_” 或 “_Material Icon Theme_” 等。可以输入完整名称或部分关键词来筛选。 在搜索结果中找到目标插件,注意核对发布者(多数常用插件都会有大量下载量,可以参考下载次数和评分)。点击插件项进入详情页。 点击绿色 “安装” 按钮。如果安装的是主题或图标类扩展,安装完成后 VSCode 通常会自动弹出一个对话框,询问你是否应用此主题/图标。比如安装 One Dark Pro 成功后,会提示是否切换到该颜色主题;安装 Material Icon Theme 后,会提示是否启用该文件图标主题。 如果看到提示,直接点击确认(Apply/启用)即可完成切换主题/图标。如果没有提示,你也可以手动切换,方法见下节。 等待片刻即安装完成。大部分插件都无需重启 VSCode即可生效(语言包是例外因为需要重启)。你可以在左侧“已安装”扩展列表中看到刚安装的插件名称。 就像这样,你可以把上面推荐的插件一个个装起来试试效果。当插件装多了,可能希望管理它们:在“已安装”列表中,你可以禁用或卸载不需要的插件,以保持编辑器性能(插件过多可能略微影响启动速度,但VSCode总体上还是很轻快的)。总之,养成按需启用插件的习惯,不用的就卸载/禁用,以后需要再装也很方便。 4.3 更换主题和美化界面 有了插件的强大功能支持,我们也别忘了让编辑器看起来赏心悦目!一个舒服的配色和整洁的界面,能让编码过程更愉快、减轻视觉疲劳。下面我们就来讲如何更换 “颜色主题” 和 “图标主题”,也就是上文提到的 GitHub Light Theme 与 Material Icon Theme 这类扩展如何发挥作用。 1. 更换颜色主题(配色): VS Code 默认提供浅色/深色等几种主题,但社区主题更加丰富多彩。假如你已经按照上文安装了 _GitHub Light Theme_(“GitHub Theme” 扩展的一部分),更换主题的方法如下: 方法一:通过安装完成后的提示切换。 安装 GitHub Theme 扩展后,VS Code 通常会弹出提示“是否切换到该主题”。若当时选择了切换,界面会立即应用 GitHub 的浅色系样式;否则继续看下面的方法。该扩展内含多个亮色变体(如 GitHub Light Default、GitHub Light High Contrast、GitHub Light Colorblind),安装后均可在主题列表里选择。 方法二:通过命令面板/菜单切换(推荐)。 打开 命令面板(Windows/Linux:Ctrl+Shift+P;macOS:⌘+Shift+P),输入 “Color Theme” 并选择 “Preferences: Color Theme”,或依次点击 “文件 → 首选项 → 主题 → 颜色主题”(macOS:“Code → 首选项 → 主题 → 颜色主题”)。此时会出现主题选择器,下/上方向键可即时预览,回车确认。下方还有 “Browse Additional Color Themes…” 入口可继续浏览更多主题。快捷键也可以直接用 Ctrl+K 然后 Ctrl+T(macOS:⌘K ⌘T)呼出主题选择器。 方法三:在扩展详情页切换。 打开 扩展 视图,进入 GitHub Theme 的详情页,点击 “Set Color Theme”(设置颜色主题)按钮也能一键应用(少数旧版可能没有该按钮)。 选择好主题后,VS Code 会记住你的选择(写入用户设置),下次启动仍然使用。想换风格时,随时按照上述步骤切换即可。 小提示:GitHub Theme 除了亮色主题,还包含暗色系列;若你对可读性或可访问性有要求(如高对比度、色弱友好),可以优先尝试 High Contrast 与 Colorblind 变体。2. 更换文件图标主题: 图标主题影响侧边栏文件列表中每种文件类型所显示的图标。默认的 VSCode 图标比较单调,而安装 Material Icon Theme 后,我们需要激活它: VSCode 安装 Material Icon Theme 插件后,会自动提示“是否切换文件图标主题为 Material Icon Theme”。点“Yes”或“启用”即可马上应用。 如果错过提示,可以通过菜单 “文件”->“首选项”->“文件图标主题” 来手动选择。在弹出的列表中选中 Material Icon Theme 即可生效。类似地,你也可以通过命令面板搜索 “Icon Theme” 来切换。 切换成功后,左侧资源管理器中的文件/文件夹图标就变得五彩缤纷了。例如 .js 文件出现黄色JS图标,.py 文件出现蛇形图标,package.json 会有 npm 图标,等等。文件夹如果命名为 src、assets 之类也会有不同图标。直观又美观,在复杂项目中通过图标快速分辨文件类型会方便不少。 如果想还原默认图标主题,也可以在同一菜单中选择“无”或“Seti (内置默认)”。 3. 用户界面其他个性化: VSCode 还有很多可自定义的界面元素,例如字体和字号(默认字体是 Consolas/Monaco 等,可以在设置中修改editor.fontFamily和editor.fontSize),行距、光标样式甚至窗口配色都能调整。但对于初学者,这些默认配置已经足够良好。等你日后变成高级用户,可以探索 VSCode 的 Settings UI 或 settings.json 来进一步个性化。在本指南中,我们重点掌握主题和图标这两处美化,已经能够显著提升体验啦! 现在,你的 VSCode 应该已经既强大又好看:中文界面 + 实用插件 + 精美主题,让我们工作更高效,心情更愉悦 🎨。下面我们来介绍 VSCode 的一些日常使用场景与入门操作,带你快速体验用 VSCode 编写和管理代码的乐趣。 五、VSCode 的日常使用场景与入门操作 完成了环境准备和界面设置,接下来你可能关心:“实际开发中我可以用 VSCode 做什么?怎样用它编写、运行代码呢?” 本节我们将结合VSCode的常见使用场景,介绍一些基本操作,帮助你从零开始尝试用 VSCode 干正事儿! 请注意,由于每个人的使用目的不同(有人用VSCode写前端网页,有人用来学Python,还有人编辑Markdown文档等等),我们无法涵盖所有语言的具体教程。但 VSCode 的核心工作流程是相通的:打开文件/文件夹 -> 编辑 -> 运行/调试 -> 保存管理。下面通过几个泛用的场景来说明VSCode的用法: 📂 打开项目或文件: VSCode 通常以“文件夹”为基本工作单元(即所谓“工作区”)。首次使用时,你可以点击菜单 “文件 -> 打开文件夹”,选择一个包含代码的文件夹,VSCode 会以该文件夹作为项目载入,左侧资源管理器会显示这个目录下的所有子文件夹和文件。你也可以直接 “文件 -> 打开文件” 来单独打开某个文件进行编辑。如果只是想新建一个临时文件试试代码,菜单 “文件 -> 新建文本文件” 即可开始一个未命名文件(稍后保存时会提示命名)。小贴士: 你也可以在欢迎页上找到“打开文件夹”、“新建文件”等快捷按钮。打开项目后,建议将VSCode窗口最大化,以便获得更大的编辑视野。 📝 编辑与保存文件: 在编辑区你可以尽情修改文本或代码。VSCode 提供了丰富的自动完成功能,比如当你写代码时,会弹出代码提示、括号自动补全、引用自动补全等等,这些都让编码变得省力。写完一段代码别忘了保存:使用快捷键 Ctrl+S (保存当前文件)或 Ctrl+Shift+S(另存为)。默认情况下,VSCode 不会自动保存文件(可以在设置中启用 auto save)。所以养成手动保存的习惯很重要,或者按需要开启“自动保存”功能。保存后,如果该文件属于一个打开的项目目录,左侧资源管理器会反映最新状态(新建的文件会出现在列表中等)。另外,VSCode 编辑器支持多光标编辑、代码折叠、查找替换(Ctrl+F / Ctrl+H)等丰富编辑操作,感兴趣可以在菜单“编辑”中查看并尝试。 🚀 运行代码/程序: VSCode 本身是编辑器,并不内置编译器或解释器,但它提供了多种方式来运行你所写的代码: 使用集成终端运行: 这是最通用的方法。比如你正在学习 Python,在 VSCode 中编写了一个 hello.py 文件。那么只需打开 终端(Terminal)面板,在提示符下输入 python hello.py 并回车,就可以执行这个脚本并在终端中看到输出结果(前提是你已安装了 Python 环境)。同样地,学 C/C++ 的可以调用 gcc/g++,学 Java 的可以用 javac/java 等。一切就像在普通命令行中运行,只不过 VSCode 把终端嵌入在了编辑器里。 使用代码运行插件: 为了简化上述过程,你可以安装类似 Code Runner 这样的扩展。这类插件可以给很多语言的源文件提供一键运行的支持(通常在编辑器右上角出现一个小三角形运行按钮)。例如装了 Code Runner 后,打开 hello.py 文件,点击运行按钮,它会在VSCode的“输出”面板中直接显示程序运行结果。对于只做简单试验的小程序,这非常方便。 针对前端网页: 如果你写的是 HTML/CSS/JavaScript 网页,使用我们推荐的 Live Server 插件就再好不过了。一键启动后,Live Server 会在浏览器打开当前 HTML 页面,并且每当你修改保存文件时,页面自动刷新显示最新效果。无需手动反复刷新浏览器,开发体验大大提升。 内置调试运行: VSCode 还内置了一个功能强大的 调试器。点击左侧 “运行和调试” 图标(类似一个小虫子🪲或三角形),你可以配置调试任务并运行程序进行调试。调试模式允许你逐行执行代码、检查变量、设置断点等,对于排查问题很有帮助。不过调试功能需要进行一定的配置(比如选择调试环境、配置launch.json等),对于初学者来说可能稍微复杂。 💻 使用集成终端: 正如前面所述,集成终端是 VSCode 的一大便利功能。建议新手多加利用它来执行各种命令,而不必在编辑器和系统终端之间来回切换。你可以通过 “终端”->“新建终端” 打开一个终端窗口(或者按快捷键 Ctrl+` )。终端默认路径即为当前打开的工作文件夹路径,非常省事。你可以在这里执行如 git 命令进行版本控制、运行构建工具(npm, make等),或者启动本地服务器等等。 **贴士:** 点击终端右上角的加号可以新建多个终端标签页,下拉箭头可以切换 Shell 类型(PowerShell、CMD、Bash 等随你喜欢)。 📊 版本控制 (Git) 操作: 如果你将来会使用 Git 管理代码,VSCode 已经为你准备好了顺手的工具。当打开一个 Git 仓库时,左侧源代码管理视图会显示变更文件列表。你可以直接在VSCode中进行 提交 (Commit)、推送 (Push)、拉取 (Pull) 等操作,而无需离开编辑器。具体而言:点击左侧第三个源代码管理图标,可以看到有哪些文件修改了,在每个文件上点开还能查看具体改动行。填写上方的消息输入框,点击 “√ 提交” 即完成 commit。右下角状态栏会显示当前分支名,点击它可以快速切换分支。runoob.comrunoob.com VSCode 与 Git 的深度集成能够满足大部分日常版本控制需求。再配合我们推荐的 GitLens 插件,还能看到每行代码的作者和提交信息等上下文。对于新手来说,可能暂时用不到高级的 Git 操作,但了解VSCode具备这能力是好的,等需要用时可以直接在图形界面完成常见任务。 🔎 全局搜索与替换: 当项目文件较多时,寻找某段代码或文本手工翻文件就太低效了。VSCode 的全局搜索功能让你一秒定位所有匹配项。点击左侧 “搜索” 图标(放大镜),在顶部搜索框输入关键字,回车后,侧边栏会列出当前打开的文件夹中所有包含该关键词的文件和行号。点击任意结果可跳转到对应文件位置,非常方便。还有一个小技巧:点击搜索框下方的“替换”切换按钮,可以进行批量替换操作。但初学者进行全局替换要谨慎,确认无误再执行。VSCode 的搜索支持正则表达式、高级筛选等,但基本用法就是这么简单直接。 ⚙️ 设置和配置: 在使用一段时间后,你也许想调整某些偏好设置,比如修改配色、字体彩色、启用自动保存等。VSCode 提供了直观的设置界面:点击左下角齿轮图标 ⚙(设置),再点“设置”就能打开图形化的设置编辑器。在搜索框输入想查找的设置项关键字即可。如搜索“auto save”可以找到自动保存选项,设置为 AfterDelay 之类即可启用自动保存。所有的配置项背后其实对应一个 JSON 文件(可以通过命令面板选择“Preferences: Open Settings (JSON)”来直接编辑配置文件)。不过新手推荐使用图形界面勾选即可,避免弄错语法。常见设置如:字体字号、主题、格式化选项、括号配对颜色、Mini Map 开关等等,都可以在这里调整。合理配置能让你的开发环境更加顺手。 以上列举的这些场景,几乎涵盖了日常使用 VSCode 的主要操作:打开 -> 编辑 -> 运行/调试 -> 版本管理 -> 搜索替换 -> 配置优化。可能一次性接受这么多信息有点多😅。别担心,新手阶段你可以从最基础的开始:先练习打开文件、编辑保存、用终端运行简单代码;当你逐渐熟悉后,再尝试集成Git、调试等进阶功能。一点点来,很快你就会体会到 VSCode 的强大和便利! 常见问题解答 在你安装和初步使用 VSCode 的过程中,可能会遇到一些小问题。别急,这里我们整理了几个常见问题并给出解决思路,希望能帮你迅速排除障碍: Q1:安装了中文语言包,但重启后界面仍然是英文? A1: 如果遇到这种情况,可以按下面步骤排查: 是否确实重启 VSCode? 很多人安装语言包后忘记点击“重启”按钮。请关闭 VSCode 并重新打开一次,看是否生效。 检查扩展是否启用: 点击左侧扩展图标,进入已安装扩展列表,看看 Chinese (Simplified) Language Pack 插件前有没有一个禁用图标(小禁牌)。如果不小心被禁用了,点一下启用它。 手动设置语言: 按 F1 或 Ctrl+Shift+P 打开命令面板,输入 “Configure Display Language” 并选择它,看看当前语言是否为 zh-cn。如果没有,手动选择 zh-cn,然后重启。 另外,可以打开 VSCode 设置文件 locale.json(路径在 Windows 下 %APPDATA%\Code\User\locale.json),确认其中 "locale": "zh-cn"。如果没有此文件可以手动创建并写入这个配置。 卸载重装语言包: 极少数情况下扩展安装可能有残留。你可以尝试在扩展列表中卸载 Chinese Language Pack,然后重新搜索安装一次,再重启。 按照以上方法通常能解决界面汉化问题。如果还有部分菜单仍是英文,不必担心——某些第三方插件的界面未翻译属正常现象。 Q2:怎样恢复 VSCode 的默认设置? A2: 如果折腾配置或插件后导致VSCode行为怪异,想恢复默认,很简单: 逐个禁用/卸载近期安装的可疑插件; 在设置 UI 或 settings.json 恢复默认; 高级做法:备份并清空 VS Code 的用户数据目录后重启(Windows:%APPDATA%\Code\;macOS:~/Library/Application Support/Code;Linux:~/.config/Code)。注意备份你的代码片段与扩展列表。此外,Windows ZIP 便携模式可将所有数据随程序目录移动。 如果还有其他没提到的情况,欢迎留言反馈,我会尽力协助解答。遇到问题时别慌,多利用搜索引擎或官方文档,社区中也有不少热心人士分享VSCode的经验,相信都能帮助你渡过难关。 恭喜你读完了这篇超全的新手指南!至此你已完成安装 → 中文化 → 认识界面 → 插件与美化 → 日常工作流的全链路入门。VS Code 的学习曲线不陡,但熟能生巧。当你逐步把它变成“顺手的兵器”,生产力会实打实地上来。下篇我们将深入讲解 调试、任务、工作区配置与常见语言的最佳实践。
-
【Docker】告别环境配置噩梦:从零到一的安装指南 一、为什么需要 Docker?🤔 在我们一头扎进技术的海洋之前,先花一分钟聊聊 Docker 是什么,以及为什么它几乎是现代开发的必备技能。 简单来说,Docker 就像一个标准化的“魔法集装箱”。它可以把你的应用程序,连同其运行所需的一切——代码、运行时库、环境变量、配置文件等等——一个不落地全部打包进去。 这样,无论你把这个“集装箱”搬到哪里——你的 Windows 电脑、同事的 Mac,还是云端的 Linux 服务器——它都能保证里面的应用以完全相同的方式运行。那句让无数开发者抓狂的“在我电脑上明明是好的!”,从此可以彻底扔进历史的垃圾堆。 对于开发者,尤其是初学者,Docker 能带来立竿见影的好处: 告别环境配置噩梦 :一键部署复杂应用,再也不用为各种依赖库的版本冲突而头疼。 保持系统纯净 🧼:所有开发环境都隔离在容器里,你的主操作系统可以永远保持清爽。 轻松分享与协作 🤝:把你的项目“集装箱”分享给伙伴,他们可以立即运行,无需任何额外配置。 迈向云原生 ☁️:Docker 是通往 Kubernetes (K8s)、微服务等更高级云原生技术的第一站和重要基石。 听起来是不是很酷?那就让我们开始动手吧! 本博文视频讲解:【Docker】告别环境配置噩梦:从零到一的安装指南_哔哩哔哩_bilibili 二、下载渠道与版本信息 编者注:请务必从官方渠道下载 Docker,这是保障软件完整性与安全性的第一道防线。 官方网站:https://www.docker.com/products/docker-desktop/ 官方文档 & 安装指南 Docker Desktop 发行说明 Docker Engine 发行说明 三、安装步骤详解 🛠️ Windows 11(安装 Docker Desktop) 启用虚拟化与 WSL 2 检查虚拟化:打开任务管理器 Ctrl+Shift+Esc → “性能”→“CPU”,确认右下角“虚拟化”状态为“已启用”。 安装/升级 WSL 2(管理员 PowerShell): wsl --install # 首次安装 wsl --set-default-version 2 wsl --update --web-download # 已安装用户更新内核完成后重启,再运行 wsl -l -v 确认发行版版本均为 2。 打开控制面板→ 程序→ 在“启用或关闭 Windows 功能”中勾选 Virtual Machine Platform(虚拟机平台) 适用于 Linux 的 Windows 子系统 (Windows Subsystem for Linux, WSL) 可选功能图片 重启电脑:根据提示,完成重启以使所有更改生效。 下载并安装 Docker Desktop 从官网下载 Docker Desktop Installer.exe。 双击运行安装程序。在向导中,确保勾选 “Use WSL 2 instead of Hyper-V (recommended)” 选项,然后一路“下一步”即可。 首次启动与订阅 安装完成后启动 Docker Desktop。首次运行时,需要接受订阅服务协议。 当系统托盘区的 🐳 小鲸鱼图标静止不动时,就代表 Docker 已经准备就绪! macOS(安装 Docker Desktop) 方法 1:官方 DMG 安装包 从 Docker 官网 根据你的芯片类型 (Intel / Apple Silicon) 下载对应的 .dmg 文件。 双击打开 .dmg 文件,将 Docker 图标拖拽到“应用程序”文件夹。 在“应用程序”中打开 Docker,根据提示完成授权(可能需要输入管理员密码)。 等待菜单栏的 🐳 图标静止,即代表安装成功。 方法 2:Homebrew 如果你的 Mac 还没有安装 Homebrew,请访问 brew.sh 获取并运行其官网提供的一行式安装命令。 确保已安装 Homebrew 如果尚未安装 Homebrew,请在终端运行: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" (Apple Silicon 可选)安装 Rosetta 2 如果你是 M1/M2 芯片,且希望运行一些仅支持 x86 的镜像,建议先安装 Rosetta: softwareupdate --install-rosetta --agree-to-license 通过 Homebrew 安装 Docker Desktop brew install --cask docker 启动 Docker Desktop 在「Launchpad」或「应用程序」中打开 Docker; 首次启动时会提示安装网络扩展及要求输入管理员密码,按提示操作即可; 启动完成后,菜单栏会出现小鲸鱼图标,表示 Docker 已就绪。 更新与卸载 更新: brew upgrade --cask docker 卸载: brew uninstall --cask docker 这样就可通过 Homebrew 快速管理 Docker Desktop 的安装、升级和卸载。 Linux (安装 Docker Engine) 提示:Ubuntu 桌面版用户同样可以安装 Docker Desktop for Linux,以获得图形化界面和一键 K8s 等功能。以下步骤用于安装纯命令行的 Docker Engine。 卸载旧版包(若存在) 如果系统上之前安装过非官方的 Docker 包,或者很老的版本,先卸载它们: # 编者注:此命令会安全地尝试移除所有已知的旧版或冲突包。 for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done sudo apt-get autoremove -y apt-get 可能会报告你没有安装这些包。 设置Docker的APT源: 打开终端,先确保系统软件包索引是最新的: sudo apt-get update sudo apt-get install ca-certificates curl 然后添加Docker官方的PGP密钥和软件源仓库: # 添加 Docker 官方 GPG 密钥: sudo apt-get update sudo apt-get install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc # 添加 Docker 仓库: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo \"$UBUNTU_CODENAME\") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update 上述命令将Docker官方源(稳定版stable通道)添加到了APT源列表中。请确保过程无错误输出。如果您使用的是Ubuntu派生发行版(如Linux Mint等),不保证100%兼容。此时源中应能检索到Docker软件包信息。 安装 Docker Engine sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin 此命令将安装Docker引擎docker-ce及其CLI、后台依赖containerd和Compose、Buildx插件。下载大小可能几十MB。安装过程中,APT会自动启动Docker服务 (dockerd)。完成后可以通过 sudo systemctl status docker 查看服务状态应为active running。 提示:如需特定版本,可在安装前使用 apt-cache madison docker-ce 查看可用版本,然后通过 sudo apt-get install docker-ce=<版本号> 来安装指定版本。一般情况下直接安装最新版本即可。 启动Docker服务 sudo systemctl start docker # 启动 sudo systemctl enable docker # 开机自启动 四、环境验证:跑个小鲸鱼看看! docker run hello-world若看到 Hello from Docker! 字样,说明镜像下载与容器运行均正常。 继续执行: docker info可查看版本、镜像/容器数量、存储驱动等详情,是排障利器。 五、配置镜像源 默认情况下,docker pull 会从国外的 Docker Hub 拉取镜像,速度可能非常慢。配置国内镜像加速器是强烈推荐的操作。 镜像源参考:https://github.com/DaoCloud/public-image-mirror 配置方法 Docker Desktop (Windows / macOS): 点击任务栏或菜单栏的鲸鱼图标,选择 Settings (设置)。 进入 Docker Engine 标签页。 在右侧的 JSON 编辑框中,加入 registry-mirrors 字段。 { "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://dislabaiot.xyz", "https://doublezonline.cloud", "https://xdark.top", "https://docker.m.daocloud.io", "https://elastic.m.daocloud.io", "https://gcr.m.daocloud.io", "https://ghcr.m.daocloud.io", "https://k8s-gcr.m.daocloud.io", "https://k8s.m.daocloud.io", "https://mcr.m.daocloud.io", "https://nvcr.m.daocloud.io", "https://quay.m.daocloud.io", "https://ollama.m.daocloud.io" ] } 点击右下角的 "Apply & Restart" 按钮,等待 Docker 重启。 配置方法 Docker Engine (Linux): 编辑(或创建)daemon.json 配置文件。 sudo nano /etc/docker/daemon.json 将以下内容写入文件: { "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://dislabaiot.xyz", "https://doublezonline.cloud", "https://xdark.top", "https://docker.m.daocloud.io", "https://elastic.m.daocloud.io", "https://gcr.m.daocloud.io", "https://ghcr.m.daocloud.io", "https://k8s-gcr.m.daocloud.io", "https://k8s.m.daocloud.io", "https://mcr.m.daocloud.io", "https://nvcr.m.daocloud.io", "https://quay.m.daocloud.io", "https://ollama.m.daocloud.io" ] } 保存文件并退出 (Ctrl+X, Y, Enter)。然后重启 Docker 服务。 sudo systemctl restart docker 六、修改默认文件路径 在 Windows 系统中,IDE 默认会将资源目录或临时文件保存在 C 盘,这容易因为权限受限或空间不足而触发红色错误提示,严重时还可能导致构建失败。我们通过以下步骤,将资源目录移至非系统盘,确保开发环境稳定可靠。 问题说明 默认位置:C:\Users\<用户名>\.your_ide\resources 潜在风险: 权限受限:系统盘目录通常需要管理员权限,不利于自动化脚本或非管理员账户操作; 空间不足:C 盘多用于系统和应用,剩余空间有限; 性能瓶颈:高 I/O 负载下,系统盘可能成为开发时的性能瓶颈。 解决方案 点击 docker desktop 窗口右上角的设置图标(⚙️)。 在设置对话框左侧,选择 Resources 选项卡。 点击中间的蓝色 Browse 按钮,弹出文件夹选择对话框。 在对话框中导航至非系统盘(例如 D:\Docker_Resources),然后点击 Select Folder。 编者注:请务必不要选择 C 盘,推荐使用 SSD 较快的分区或专用磁盘,以获得最佳 I/O 性能。 回到设置窗口,点击右下角的 Apply & Restart,让 IDE 重新启动并应用新配置。 Resources 路径配置界面图片 七、Docker 卸载与升级指南 完全卸载 Docker 重要提示:卸载会移除所有本地的镜像、容器、卷和网络。如有重要数据,请提前备份! Windows (Docker Desktop): 在 "设置" > "应用" > "应用和功能" 中找到 "Docker Desktop" 并点击 "卸载"。 macOS (Docker Desktop): 打开 Docker Desktop 应用,点击菜单栏的 🐳 图标 > "Troubleshoot" > "Uninstall"。 Ubuntu (Docker Engine): ```Bash # 1. 卸载所有相关包 sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin sudo apt-get autoremove -y --purge # 2. 删除所有数据 sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd ``` 升级 Docker Docker Desktop: 应用内置了自动更新功能。当有新版本时,通常会弹出通知。你只需点击通知并按提示操作即可。也可以在菜单中手动点击 "Check for Updates"。 Docker Engine (Ubuntu): 如果你是通过 APT 仓库安装的,升级非常简单,就如同更新其他系统软件一样: sudo apt-get update sudo apt-get install -y --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin 📺 推荐视频教程
-
【安装】快速安装 Cherry Studio 介绍 Cherry Studio 是一款功能全面的 AI 助手桌面客户端,集成了多种大型语言模型(LLM),能够帮助用户轻松完成文本生成、对话交互、知识检索等任务。无论是日常办公、编程辅助,还是创意写作,都能大幅提升效率。 一、下载与安装 打开官网: Cherry Studio 官方网站 – 全能的 AI 助手 点击【下载客户端】,根据自己的系统环境选择对应版本: Windows 64 位(x64) Windows 32 位(x86) macOS Linux 运行安装程序,按照向导依次点击【下一步】即可。 安装位置建议: 默认安装在 C:\Program Files\Cherry Studio 为避免占用系统盘空间,建议改为其他盘符,例如 D:\Cherry Studio 二、LLM 大模型配置 启动 Cherry Studio,点击界面左下角的 “设置” 图标。 在侧栏选择 “模型服务”,填写以下信息: 服务地址(Endpoint) Access Key / Token 默认模型名称 切换到 “助手” 面板,可选择或添加新的 LLM 服务实例、调整模型参数(如温度、最大长度等)。 配置完成后,点击【保存并测试】,确保连接正常即可开始使用。 三、常用快捷键 功能快捷键界面放大Ctrl + =界面缩小Ctrl + -重置缩放Ctrl + 0打开/关闭设置Ctrl + ,调出快捷助手Ctrl + E新建话题Ctrl + N切换助手显示Ctrl + [切换话题显示Ctrl + ]复制上一条消息Ctrl + Shift + C搜索消息Ctrl + F清空消息Ctrl + L清除上下文Ctrl + K更多快捷键及高级配置,请参考官方文档: https://docs.cherry-ai.com/ 四、后续计划 本文主要记录了 Cherry Studio 的安装与基础配置流程,后续将推出详细的使用教程与实战视频,目前一个想法是基于LLM大模型自己写mcp sever。 点击此链接观看本文视频版
-
【安装】R 、R Studio 、R Tools 安装 注意事项 请先安装 R,再安装 RStudio。 建议将 R 和 RStudio 安装在同一目录下,例如在 D 盘新建一个名为 R 的文件夹(D:\R)。 安装路径中请勿包含中文字符或空格,以免引发潜在问题。 R 语言与 R Tools 的下载及安装流程 选择 CRAN 镜像源 访问 CRAN: Mirrors 页面,在 China 区域任选一个镜像源即可。这里推荐使用清华大学的镜像:The Comprehensive R Archive Network 选择系统版本 根据您的操作系统选择对应版本: Download R for Linux (Debian, Fedora/Redhat, Ubuntu) Download R for macOS Download R for Windows 对于 Windows 用户,点击 Download R for Windows 后,再进入 base 文件夹,点击 Download R-4.4.2 for Windows 即可。 运行安装程序 双击下载的 R-4.4.2-win.exe 安装包,启动安装向导。选择 中文简体 后点击 确定。 选择安装目录 可以选择默认目录或自定义安装位置(建议不要使用含有中文或空格的路径),然后点击 下一步。 选择组件 根据需要勾选相应组件后继续点击 下一步。 注意: 建议取消勾选 “Message translation”,以便后续调试时更容易查找错误原因。 自定义安装选项 建议保持默认设置。以下是 “Yes(自定义启动)” 选项的说明: 窗口显示模式: 选择大窗口或多窗口显示模式。 帮助文本显示: 选择纯文本或 HTML(网页)格式显示。 快捷方式与启动选项: 是否在桌面或开始菜单创建快捷方式,建议不勾选,因为主要通过 RStudio 来运行代码。 环境变量配置: 默认安装程序会自动配置环境变量,大部分用户无需调整。若需手动配置,请按以下步骤操作: Win11: 按 Win 键,搜索 “环境变量”,点击 “环境变量(N)” > 在 “系统变量(S)” 中找到 Path,双击打开,点击 “新建”,输入 R.exe 的路径,例如:D:\R\R-4.4.2\bin Win10: 右键点击 “我的电脑” > 选择 “属性” > 点击 “高级系统设置” > 在 “系统变量(S)” 下找到 Path,双击打开,点击 “新建”,输入 R.exe 的路径,例如:D:\R\R-4.4.2\bin 可通过按 Win + R 打开命令提示符(cmd),输入 R,若显示一大串信息,则说明环境变量配置成功。 环境变量配置示例图片 命令提示符验证图片 安装 R Tools 仅 Windows 系统需要安装 R Tools。 安装完成后,可选择是否启动 R,点击 “完成” 退出安装向导。 接下来,返回第二步,重新访问清华大学镜像源:The Comprehensive R Archive Network,依次点击: Download R for Windows > Rtools > 选择与所安装 R 语言大版本相对应的 RTools(例如 R 语言版本为 4.4.2,则选择 RTools 4.4),下载 Rtools 4.4 installer。 将 R Tools 安装在与 R 语言相同的目录下(例如:D:\R)。 RStudio 的下载与安装 下载 RStudio 访问 RStudio Desktop - Posit,向下滚动页面找到适用于您操作系统的 RStudio 安装包。 安装 RStudio 双击下载的安装包,按照提示完成安装。安装过程中无需额外配置,建议保持默认设置,并确保安装位置与 R 语言的安装路径一致(例如:D:\R)。 启动 RStudio 并关联 R 环境 安装完成后,启动 RStudio 并点击 OK。RStudio 会自动检测系统中已安装的 R 语言环境。若未自动检测到,可按照以下步骤手动设置: 进入 Tools -> Global Options -> General 在 “R version” 一栏中手动指定 R 的安装路径。 更换第三方库的镜像源 在 RStudio 中,依次点击 Tools -> Global Options -> Packages -> 在 “Primary CRAN repository:” 处点击 Change,选择一个国内的镜像源即可。 点击此文本观看本文视频版