From ba7b6fdec5962eaba5292a002d14251a65f0070e Mon Sep 17 00:00:00 2001 From: hf_trixie Date: Sat, 15 Aug 2026 01:18:51 +0800 Subject: 审查并修改_1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/applications/programming/cpp.md | 88 +++------------------------- docs/applications/programming/miniconda.md | 67 ++++----------------- docs/applications/programming/python.md | 93 ++---------------------------- 3 files changed, 24 insertions(+), 224 deletions(-) (limited to 'docs/applications/programming') diff --git a/docs/applications/programming/cpp.md b/docs/applications/programming/cpp.md index 22b0b0f..5f99a01 100644 --- a/docs/applications/programming/cpp.md +++ b/docs/applications/programming/cpp.md @@ -1,17 +1,12 @@ -# C++ +# C++开发套件 -## Windows 的配置灾难 +## g++ -众所周知,在windows上安装VSCode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情。 -因为 Windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利。 +### 概述 -如果你选择了 Linux ,那么恭喜你将获得一个非常便利而自然的开发环境。 -接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译。 +g++是GNU项目开发的C++编译器,属于GNU编译器套件(GCC)的核心组成部分。它通过命令行运行,能把C++源代码文件编译、链接并转换成计算机可以直接运行的二进制可执行程序。 -## g++ 安装 - -g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)。 -安装非常简单,取决于你使用什么包管理器。 +### 安装 - Debian 系(Ubuntu, Mint, Debian) @@ -31,77 +26,8 @@ sudo dnf install g++ -y sudo pacman -S g++ -y ``` -- 查看版本 - -```bash -g++ -v -``` - -参考输出: -❯ g++ -v - -```shell -Using built-in specs. -COLLECT_GCC=g++ -COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-pc-linux-gnu/16/lto-wrapper -Target: x86_64-pc-linux-gnu -Configured with: ../gcc/configure --enable-languages=ada,c,c++,d,fortran,go,lto,m2,objc,obj-c++,rust,cobol --enable-bootstrap --prefix=/usr --libdir=/usr/lib --libexecdir=/usr/lib --mandir=/usr/share/man --infodi -r=/usr/share/info --with-bugurl=https://gitlab.archlinux.org/archlinux/packaging/packages/gcc/-/issues --with-build-config=bootstrap-lto --with-gcc-major-version-only --with-linker-hash-style=gnu --with-system-zl -ib --enable-cet=auto --enable-checking=release --enable-clocale=gnu --enable-default-pie --enable-default-ssp --enable-gnu-indirect-function --enable-gnu-unique-object --enable-libstdcxx-backtrace --enable-link-s -erialization=1 --enable-linker-build-id --enable-lto --enable-multilib --enable-plugin --enable-shared --enable-threads=posix --disable-fixincludes --disable-libssp --disable-libstdcxx-pch --disable-werror -Thread model: posix -Supported LTO compression algorithms: zlib zstd -gcc version 16.1.1 20260725 (GCC) -``` - +### 使用 -## 编写一个程序 - -- 创建一个cpp文件(以cpp为后缀) - -```bash -touch hello.cpp -``` - -- 使用你喜欢的编辑器打开 - -```bash -vim hello.cpp -# 如果你不会用 vim 就用nano -# nano hello.cpp -``` - -- 写入下面的内容 - -```cpp -#include - -int main() { - std::cout << "hello world" << std::endl; - return 0; -} -``` - -- 保存并退出 - -- 编译成二进制文件 - -```bash -g++ hello.cpp -o hello -``` - -> -o Place the output into . -这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名。 - -写法是 g++ 源文件路径 -o 二进制文件。 - -- 运行程序 - -```bash -./hello # ./ 表示当前目录, 后面直接跟上文件名, 表示运行该二进制文件 -``` +请参考`man g++`。 -这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个C++程序。 -现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了。 -祝贺你。 diff --git a/docs/applications/programming/miniconda.md b/docs/applications/programming/miniconda.md index 72ba4f9..a256a8d 100644 --- a/docs/applications/programming/miniconda.md +++ b/docs/applications/programming/miniconda.md @@ -1,84 +1,41 @@ # Miniconda -## 什么是Miniconda +## 概述 -相信不少人是因为自己需要学习人工智能,跑云端训练才学Linux -所以我在这里写了相关的内容,希望可以帮助到大家。 +Miniconda的上游Anaconda是一个**Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。但Anaconda过于臃肿,因此官方也推出了最小化版本,也就是Miniconda。 -Anaconda 是一个 **Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。 -但是 Anaconda 预装太多东西,甚至达到几个G的体积,所以官方也推出了mini版 —— Miniconda。 +Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,让用户按需安装。 -Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,比如numpy之类的。 -它的设计理念就是让用户按需安装,我是比较同意这个理念的,个人也一直在用Miniconda。 +## 安装 -**下面的教程适用于Linux环境(包括原生Linux,WSL,虚拟机等)** - -## 安装步骤 - -- 下载官方安装脚本 -访问官方下载链接( - -选择 Linux,选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)。 +下载官方安装脚本,访问[官方下载链接](https://www.anaconda.com/download/success),选择 Linux,选择右边Miniconda,架构请自行查询,一般情况为x86。 ![Anaconda安装脚本下载](../../img/miniconda/pic1.png) -- 使用bash执行脚本 +使用bash执行脚本 ```bash -# 首先需要把你的 Miniconda脚本放到Linux系统可以访问的地方 - -# 然后执行这个安装脚本 bash Miniconda3-latest-Linux-x86_64.sh ``` -然后中间有引导,保持默认即可,叫你输yes你就yes回车。安装完之后重启终端或者使用下面的命令重新加载环境变量。 +选项保持默认即可。安装完之后重启终端或者使用下面的命令重新加载环境变量。 ```bash source ~/.bashrc ``` -- 配置镜像源 - -很多同志连官方源不太流畅,推荐换成中科大。 +## 镜像源 -访问这个链接进行配置即可: +访问这个链接进行配置即可(中科大源): -一般是创建一个 ~/.condarc 文件然后把 channels 开头的那些东西复制粘贴进去即可。 +创建一个`~/.condarc`文件然后把channels开头的文本复制粘贴进去即可。 ```bash # 创建配置文件 touch ~/.condarc -# 然后编辑 +# 编辑配置文件 nano ~/.condarc ``` -- 配置pip源 +此外,还需要配置pip源,建议访问这个网址进行配置(中科大源) -我们很多时候还是使用 pip 来安装的,所以这里也需要配置一下pip的镜像源 - -访问这个网址进行配置 -**只需要执行设为默认的命令即可**, 剩下的不需要配置。 - -- 创建环境测试 - -```bash -# 这边的 -n 后面的是虚拟环境名, 这里既是 test-env. 然后后面可以指定python版本,根据实验需要来 -conda create -n test-env python=3.12 -``` - -- pip安装测试 - -```bash -# 先激活刚才创建的虚拟环境 -conda activate test-env - -# 然后装个 numpy 试试 -pip install numpy -``` - -- 查看当前环境 - -```bash -conda env list -# 列出所有环境, 如果是当前的环境, 会标有 * -``` diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md index 1180d39..bbc0af9 100644 --- a/docs/applications/programming/python.md +++ b/docs/applications/programming/python.md @@ -1,93 +1,10 @@ -# Python +# Python开发套件 -## 安装 Python +## Python3 -Linux 上装Python还是非常轻松的,因为不用装,大部分发行版自带。 +### 安装 -Linux 里面一般都是 `python3`。 -如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。 +无须安装,发行版自带。 -- Debian: `sudo apt install python-is-python3 -y` -- Fedora: `sudo dnf install python-is-python3 -y` +Linux里面一般以`python3`命令使用Python。 -## 编写第一个脚本 - -- 创建一个脚本 - -```bash -touch hello.py -``` - -- 写入内容 - -```bash -echo "print('hello python')" > hello.py -``` - -- 查看内容 - -```bash -cat hello.py - -# 会输出 -# print('hello python') -``` - -## 运行 - -有很多Windows来的同志不知道怎么运行,但实际上非常简单。 - -用法: - -```bash -# python <要运行的脚本路径> - -python hello.py -``` - -这样你就成功运行起 Python 脚本了。 -实际上就是给 Python 指定需要运行的文件, 就这么简单。 - -恭喜你在Linux上成功运行了Python脚本。 - -## 编辑器 - -- 如果你使用WSL, 推荐使用 VSCode 的 WSL 插件来连接写代码, 当然勇敢牛牛可以尝试 LazyVim 写代码 -- 如果你使用原生 Linux, 还是这两种推荐haha - -VSCode 资料很多, 我也用的比较少,可以直接上Bilibili搜索VSCode Python环境搭建 -[LazyVim入坑视频](https://www.bilibili.com/video/BV1TJCvYFE2T?t=286.5) - -## 库 - -Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。但在Linux下,`pip`不一定会随着Python预装,因此需要使用包管理器安装。 - -- Debian: `sudo apt install python3-pip` -- Fedora: `sudo dnf install python3-pip` -- Arch: `sudo pacman -S python-pip` - -!!! warning "系统依赖" - 使用Pip安装部分库时,可能会出现如下警告: - ``` - error: externally-managed-environment - - × This environment is externally managed - ╰─> To install Python packages system-wide, try 'pacman -S - python-xyz', where xyz is the package you are trying to - install. - - If you wish to install a non-Arch-packaged Python package, - create a virtual environment using 'python -m venv path/to/venv'. - Then use path/to/venv/bin/python and path/to/venv/bin/pip. - - If you wish to install a non-Arch packaged Python application, - it may be easiest to use 'pipx install xyz', which will manage a - virtual environment for you. Make sure you have python-pipx - installed via pacman. - - note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. - hint: See PEP 668 for the detailed specification. - ``` - 由于系统的部分组件依赖Python的依赖,因而外来库可能破坏系统本身的依赖关系。 - - 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。 \ No newline at end of file -- cgit v1.3 From 33830d56659c215d054012b402a96bcb6b297c14 Mon Sep 17 00:00:00 2001 From: hf_trixie Date: Sat, 15 Aug 2026 05:32:50 +0200 Subject: 添加Arch系安装方法,隔离使用 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/applications/programming/python.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) (limited to 'docs/applications/programming') diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md index bbc0af9..a6b3233 100644 --- a/docs/applications/programming/python.md +++ b/docs/applications/programming/python.md @@ -4,7 +4,14 @@ ### 安装 -无须安装,发行版自带。 +除个别极简发行版外(如Arch),大多数发行版已自带。 + +Arch系: +```bash +sudo pacman -S python +``` + +### 使用 Linux里面一般以`python3`命令使用Python。 -- cgit v1.3 From 7426556d8d5a84d6a5eb129a2563e6ea6bf57cd0 Mon Sep 17 00:00:00 2001 From: at2er Date: Sat, 15 Aug 2026 11:49:17 +0800 Subject: fix(git.md, miniconda.md): default expand tips and optimize mirror link --- docs/applications/git.md | 6 +++--- docs/applications/programming/miniconda.md | 5 ++--- 2 files changed, 5 insertions(+), 6 deletions(-) (limited to 'docs/applications/programming') diff --git a/docs/applications/git.md b/docs/applications/git.md index 376ec9f..ad481a6 100644 --- a/docs/applications/git.md +++ b/docs/applications/git.md @@ -54,7 +54,7 @@ git add 修改的文件 git commit -m "这一次提交的介绍" ``` -???- tip "不带`-m`参数" +???+ tip "不带`-m`参数" 您可以不加`-m`参数,Git会根据您当前的`EDITOR`环境变量打开一个编辑器让您填写信息 您可以使用`echo $EDITOR`得知当前编辑器是什么 @@ -69,7 +69,7 @@ git commit -m "这一次提交的介绍" git log ``` -???- tip "如果您想要一个更加简洁的界面" +???+ tip "如果您想要一个更加简洁的界面" `git log --oneline` ### 回退版本 @@ -93,4 +93,4 @@ git log 2. [菜鸟教程](https://www.runoob.com/git/git-tutorial.html) 3. [一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) 4. [蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) -5. [Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) \ No newline at end of file +5. [Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) diff --git a/docs/applications/programming/miniconda.md b/docs/applications/programming/miniconda.md index a256a8d..ba1d605 100644 --- a/docs/applications/programming/miniconda.md +++ b/docs/applications/programming/miniconda.md @@ -26,7 +26,7 @@ source ~/.bashrc ## 镜像源 -访问这个链接进行配置即可(中科大源): +访问[中科大源](https://mirrors.ustc.edu.cn/help/anaconda.html)进行配置即可 创建一个`~/.condarc`文件然后把channels开头的文本复制粘贴进去即可。 @@ -37,5 +37,4 @@ touch ~/.condarc nano ~/.condarc ``` -此外,还需要配置pip源,建议访问这个网址进行配置(中科大源) - +此外,还需要配置pip源,建议访问[中科大源](https://mirrors.ustc.edu.cn/help/pypi.html)进行配置 -- cgit v1.3 From 98073d6c2673663a1c04efda8295b7c3def821ab Mon Sep 17 00:00:00 2001 From: at2er Date: Sat, 15 Aug 2026 11:56:31 +0800 Subject: feat(python.md): 'python-is-python3' --- docs/applications/programming/python.md | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs/applications/programming') diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md index a6b3233..6629a08 100644 --- a/docs/applications/programming/python.md +++ b/docs/applications/programming/python.md @@ -15,3 +15,8 @@ sudo pacman -S python Linux里面一般以`python3`命令使用Python。 +???+ tip "通过`python`使用" + 如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。 + + - Debian: `sudo apt install python-is-python3 -y` + - Fedora: `sudo dnf install python-is-python3 -y` -- cgit v1.3 From c9a2942ac34e94ee873ed57e29e011a67bc3d9c4 Mon Sep 17 00:00:00 2001 From: at2er Date: Sat, 15 Aug 2026 14:13:38 +0800 Subject: revert(python): library --- docs/applications/programming/python.md | 34 +++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) (limited to 'docs/applications/programming') diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md index 6629a08..29ad315 100644 --- a/docs/applications/programming/python.md +++ b/docs/applications/programming/python.md @@ -20,3 +20,37 @@ Linux里面一般以`python3`命令使用Python。 - Debian: `sudo apt install python-is-python3 -y` - Fedora: `sudo dnf install python-is-python3 -y` + +## 库 + +Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。但在Linux下,`pip`不一定会随着Python预装,因此需要使用包管理器安装。 + +- Debian: `sudo apt install python3-pip` +- Fedora: `sudo dnf install python3-pip` +- Arch: `sudo pacman -S python-pip` + +!!! warning "系统依赖" + 使用Pip安装部分库时,可能会出现如下警告: + ``` + error: externally-managed-environment + + × This environment is externally managed + ╰─> To install Python packages system-wide, try 'pacman -S + python-xyz', where xyz is the package you are trying to + install. + + If you wish to install a non-Arch-packaged Python package, + create a virtual environment using 'python -m venv path/to/venv'. + Then use path/to/venv/bin/python and path/to/venv/bin/pip. + + If you wish to install a non-Arch packaged Python application, + it may be easiest to use 'pipx install xyz', which will manage a + virtual environment for you. Make sure you have python-pipx + installed via pacman. + + note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. + hint: See PEP 668 for the detailed specification. + ``` + 由于系统的部分组件依赖Python的依赖,因而外来库可能破坏系统本身的依赖关系。 + + 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。 -- cgit v1.3