From 63a82ce0c59c94f478eb31a277b14fadf11aec12 Mon Sep 17 00:00:00 2001 From: krahets Date: Mon, 4 Dec 2023 05:10:06 +0800 Subject: [PATCH] build --- docs/chapter_appendix/contribution.md | 4 +- docs/chapter_appendix/installation.md | 60 ++++++++++++++++----------- 2 files changed, 38 insertions(+), 26 deletions(-) diff --git a/docs/chapter_appendix/contribution.md b/docs/chapter_appendix/contribution.md index c840fa2b6..4b7b79204 100644 --- a/docs/chapter_appendix/contribution.md +++ b/docs/chapter_appendix/contribution.md @@ -16,7 +16,7 @@ comments: true ### 1.   内容微调 -如图 16-1 所示，每个页面的右上角都有“编辑图标”。您可以按照以下步骤修改文本或代码。 +如图 16-3 所示，每个页面的右上角都有“编辑图标”。您可以按照以下步骤修改文本或代码。 1. 点击“编辑图标”，如果遇到“需要 Fork 此仓库”的提示，请同意该操作。 2. 修改 Markdown 源文件内容，检查内容的正确性，并尽量保持排版格式的统一。 @@ -24,7 +24,7 @@ comments: true ![页面编辑按键](contribution.assets/edit_markdown.png){ class="animation-figure" } -

图 16-1   页面编辑按键

+

图 16-3   页面编辑按键

图片无法直接修改，需要通过新建 [Issue](https://github.com/krahets/hello-algo/issues) 或评论留言来描述问题，我们会尽快重新绘制并替换图片。 diff --git a/docs/chapter_appendix/installation.md b/docs/chapter_appendix/installation.md index 9c73db9dc..44baa6235 100644 --- a/docs/chapter_appendix/installation.md +++ b/docs/chapter_appendix/installation.md @@ -4,26 +4,44 @@ comments: true # 16.1   编程环境安装 -### 1.   VSCode +## 16.1.1   安装 IDE -本书推荐使用开源、轻量的 VSCode 作为本地 IDE ，下载并安装 [VSCode](https://code.visualstudio.com/) 。 +推荐使用开源、轻量的 VSCode 作为本地集成开发环境（IDE）。访问 [VSCode 官网](https://code.visualstudio.com/)，根据操作系统选择相应版本的 VSCode 进行下载和安装。 -### 2.   Java 环境 +![从官网下载 VSCode](installation.assets/vscode_installation.png){ class="animation-figure" } -1. 下载并安装 [OpenJDK](https://jdk.java.net/18/)（版本需满足 > JDK 9）。 -2. 在 VSCode 的插件市场中搜索 `java` ，安装 Extension Pack for Java 。 +

图 16-1   从官网下载 VSCode

-### 3.   C/C++ 环境 +VSCode 拥有强大的扩展包生态系统，支持大多数编程语言的运行和调试。以 Python 为例，安装“Python Extension Pack”扩展包之后，即可进行 Python 代码调试。安装步骤如图 16-2 所示。 + +![安装 VSCode 扩展包](installation.assets/vscode_extension_installation.png){ class="animation-figure" } + +

图 16-2   安装 VSCode 扩展包

+ +## 16.1.2   安装语言环境 + +### 1.   Python 环境 + +1. 下载并安装 [Miniconda3](https://docs.conda.io/en/latest/miniconda.html) ，需要 Python 3.10 或更新版本。 +2. 在 VSCode 的插件市场中搜索 `python` ，安装 Python Extension Pack 。 +3. （可选）在命令行输入 `pip install black` ，安装代码格式化工具。 + +### 2.   C/C++ 环境 1. Windows 系统需要安装 [MinGW](https://sourceforge.net/projects/mingw-w64/files/)（[配置教程](https://blog.csdn.net/qq_33698226/article/details/129031241)）；MacOS 自带 Clang ，无须安装。 2. 在 VSCode 的插件市场中搜索 `c++` ，安装 C/C++ Extension Pack 。 3. （可选）打开 Settings 页面，搜索 `Clang_format_fallback Style` 代码格式化选项，设置为 `{ BasedOnStyle: Microsoft, BreakBeforeBraces: Attach }` 。 -### 4.   Python 环境 +### 3.   Java 环境 -1. 下载并安装 [Miniconda3](https://docs.conda.io/en/latest/miniconda.html) ，需要 Python 3.10 或更新版本。 -2. 在 VSCode 的插件市场中搜索 `python` ，安装 Python Extension Pack 。 -3. （可选）在命令行输入 `pip install black` ，安装代码格式化工具。 +1. 下载并安装 [OpenJDK](https://jdk.java.net/18/)（版本需满足 > JDK 9）。 +2. 在 VSCode 的插件市场中搜索 `java` ，安装 Extension Pack for Java 。 + +### 4.   C# 环境 + +1. 下载并安装 [.Net 8.0](https://dotnet.microsoft.com/en-us/download) 。 +2. 在 VSCode 的插件市场中搜索 `C# Dev Kit` ，安装 C# Dev Kit （[配置教程](https://code.visualstudio.com/docs/csharp/get-started)）。 +3. 也可使用 Visual Studio（[安装教程](https://learn.microsoft.com/zh-cn/visualstudio/install/install-visual-studio?view=vs-2022)）。 ### 5.   Go 环境 @@ -31,29 +49,23 @@ comments: true 2. 在 VSCode 的插件市场中搜索 `go` ，安装 Go 。 3. 按快捷键 `Ctrl + Shift + P` 呼出命令栏，输入 go ，选择 `Go: Install/Update Tools` ，全部勾选并安装即可。 -### 6.   JavaScript 环境 +### 6.   Swift 环境 + +1. 下载并安装 [Swift](https://www.swift.org/download/) 。 +2. 在 VSCode 的插件市场中搜索 `swift` ，安装 [Swift for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=sswg.swift-lang) 。 + +### 7.   JavaScript 环境 1. 下载并安装 [node.js](https://nodejs.org/en/) 。 2. 在 VSCode 的插件市场中搜索 `javascript` ，安装 JavaScript (ES6) code snippets 。 3. （可选）在 VSCode 的插件市场中搜索 `Prettier` ，安装代码格式化工具。 -### 7.   C# 环境 - -1. 下载并安装 [.Net 8.0](https://dotnet.microsoft.com/en-us/download) 。 -2. 在 VSCode 的插件市场中搜索 `C# Dev Kit` ，安装 C# Dev Kit （[配置教程](https://code.visualstudio.com/docs/csharp/get-started)）。 -3. 也可使用 Visual Studio（[安装教程](https://learn.microsoft.com/zh-cn/visualstudio/install/install-visual-studio?view=vs-2022)）。 - -### 8.   Swift 环境 - -1. 下载并安装 [Swift](https://www.swift.org/download/) 。 -2. 在 VSCode 的插件市场中搜索 `swift` ，安装 [Swift for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=sswg.swift-lang) 。 - -### 9.   Dart 环境 +### 8.   Dart 环境 1. 下载并安装 [Dart](https://dart.dev/get-dart) 。 2. 在 VSCode 的插件市场中搜索 `dart` ，安装 [Dart](https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code) 。 -### 10.   Rust 环境 +### 9.   Rust 环境 1. 下载并安装 [Rust](https://www.rust-lang.org/tools/install) 。 2. 在 VSCode 的插件市场中搜索 `rust` ，安装 [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer) 。