aboutsummaryrefslogtreecommitdiff
path: root/docs/applications/programming
diff options
context:
space:
mode:
authorFangcatChina <f20091219@outlook.com>2026-07-29 05:46:18 +0000
committerFangcatChina <f20091219@outlook.com>2026-07-29 05:46:18 +0000
commitda66ac105db2773a8a6db03398d68283279cf69c (patch)
tree064eb8544bc8e306ae6c0e310ecee8e0877a2d73 /docs/applications/programming
parentMerge pull request #15 from LinuxCabin/imgbot (diff)
Merge #14
Diffstat (limited to '')
-rw-r--r--docs/applications/programming/cpp.md (renamed from pending/cpp_compile_beginner/cpp_compile_beginner.md)47
-rw-r--r--docs/applications/programming/miniconda.md (renamed from docs/applications/miniconda.md)2
-rw-r--r--docs/applications/programming/python.md93
3 files changed, 118 insertions, 24 deletions
diff --git a/pending/cpp_compile_beginner/cpp_compile_beginner.md b/docs/applications/programming/cpp.md
index 118a1c4..e5d01b7 100644
--- a/pending/cpp_compile_beginner/cpp_compile_beginner.md
+++ b/docs/applications/programming/cpp.md
@@ -1,32 +1,36 @@
-# 在 Linux 上运行 cpp 代码
+# C++
## Windows 的配置灾难
-众所周知,在windows上安装vscode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情
-因为 windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利
+众所周知,在windows上安装VSCode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情。
+因为 Windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利。
-如果你选择了 Linux 那么恭喜你将获得一个非常便利而自然的开发环境
-接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译
-
----
+如果你选择了 Linux ,那么恭喜你将获得一个非常便利而自然的开发环境。
+接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译。
## g++ 安装
-g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)
-安装非常简单,取决于你使用什么包管理器
+g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)。
+安装非常简单,取决于你使用什么包管理器。
-- Debian 系列(ubuntu, mint, debian)
+- Debian 系(Ubuntu, Mint, Debian)
```bash
sudo apt install g++ -y
```
-- RHEL 系列(fedora, rhel, rocky)
+- 红帽系(Fedora, rhel, rocky)
```bash
sudo dnf install g++ -y
```
+- Arch系
+
+```bash
+sudo pacman -S g++ -y
+```
+
- 查看版本
```bash
@@ -50,7 +54,6 @@ Supported LTO compression algorithms: zlib zstd
gcc version 16.1.1 20260725 (GCC)
```
----
## 编写一个程序
@@ -88,9 +91,9 @@ g++ hello.cpp -o hello
```
> -o <file> Place the output into <file>.
-这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名
+这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名。
-写法是 g++ 源文件路径 -o 二进制文件
+写法是 g++ 源文件路径 -o 二进制文件。
- 运行程序
@@ -98,15 +101,13 @@ g++ hello.cpp -o hello
./hello # ./ 表示当前目录, 后面直接跟上文件名, 表示运行该二进制文件
```
-这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个cpp程序
-
----
+这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个C++程序。
## 多文件编译
-当我们的源文件不止一个的时候, 我们需要在编译的时候把所有用到的源文件都写上(当然仅限于自己写的那些源文件,标准库就不需要了)
+当我们的源文件不止一个的时候, 我们需要在编译的时候把所有用到的源文件都写上(当然仅限于自己写的那些源文件,标准库就不需要了)。
-比如说这个项目
+比如说这个项目:
```bash
❯ tree
@@ -148,7 +149,7 @@ g++ hello.cpp -o hello
│   └── simdutf.cpp
```
-不要看有这么多文件, 但是这个明显是一个 header only 的项目, 只有 src/ 目录里面有两个cpp 文件,所以我们只需要编译的时候指定这两个即可
+不要看有这么多文件, 但是这个明显是一个 header only 的项目, 只有 src/ 目录里面有两个cpp 文件,所以我们只需要编译的时候指定这两个即可。
```bash
# 创建一个 bin 目录放产物 如果你还没有的话
@@ -160,7 +161,7 @@ g++ src/simdutf.cpp src/main.cpp -o bin/main
# 直接使用通配符编译所有的cpp文件
```
-这里给个建议就是将cpp源文件和hpp头文件分开,这样方便管理
+这里给个建议就是将cpp源文件和hpp头文件分开,这样方便管理。
-现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了
-祝贺你
+现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了。
+祝贺你。
diff --git a/docs/applications/miniconda.md b/docs/applications/programming/miniconda.md
index de77859..cd445af 100644
--- a/docs/applications/miniconda.md
+++ b/docs/applications/programming/miniconda.md
@@ -20,7 +20,7 @@ Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,比å¦
选择 Linux,选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)。
-![Anaconda安装脚本下载](../img/miniconda/pic1.png)
+![Anaconda安装脚本下载](../../img/miniconda/pic1.png)
- 使用bash执行脚本
diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md
new file mode 100644
index 0000000..1180d39
--- /dev/null
+++ b/docs/applications/programming/python.md
@@ -0,0 +1,93 @@
+# Python
+
+## 安装 Python
+
+Linux 上装Python还是非常轻松的,因为不用装,大部分发行版自带。
+
+Linux 里面一般都是 `python3`。
+如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。
+
+- Debian: `sudo apt install python-is-python3 -y`
+- Fedora: `sudo dnf install python-is-python3 -y`
+
+## 编写第一个脚本
+
+- 创建一个脚本
+
+```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