Skip to content

Commit bbe1bf2

Browse files
committed
[update]
1 parent a3246db commit bbe1bf2

7 files changed

Lines changed: 105 additions & 80 deletions

File tree

docs/.vuepress/config.ts

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -24,21 +24,16 @@ export default defineUserConfig({
2424
docsDir: "docs",
2525
docsBranch: "main",
2626

27-
/* 页内信息 */
2827
editLink: true,
2928
contributors: false,
30-
// changelog: false,
29+
changelog: false,
3130

32-
blog: false, // 禁用博客
31+
blog: false,
3332

3433
/* 博客文章页面链接前缀 */
3534
// article: '/article/',
3635
cache: "filesystem",
3736

38-
/**
39-
* 为 markdown 文件自动添加 frontmatter 配置
40-
* @see https://theme-plume.vuejs.press/config/basic/#autofrontmatter
41-
*/
4237
autoFrontmatter: {
4338
permalink: true, // 是否生成永久链接
4439
createTime: false, // 是否生成创建时间
@@ -63,10 +58,7 @@ export default defineUserConfig({
6358
annotation: true, // 启用 annotation 语法 [+label]: content
6459
caniuse: true, // 启用 caniuse 语法 @[caniuse](feature_name)
6560
plot: true, // 启用隐秘文本语法 !!xxxx!!
66-
bilibili: true, // 启用嵌入 bilibili视频 语法 @[bilibili](bid)
67-
youtube: true, // 启用嵌入 youtube视频 语法 @[youtube](video_id)
6861
icon: { provider: "iconify" }, // 启用内置图标语法 ::icon-name::
69-
table: true, // 启用表格增强容器语法 ::: table
7062
repl: {
7163
// 启用 代码演示容器
7264
python: true, // ::: python-repl

docs/0 前言/0.3 Python环境安装.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ copyright:
44
permalink: /jvvxy8eb/
55
---
66

7-
# Python环境安装
7+
# Python 环境安装
88

99
由于精力有限,本文介绍的是 `Python 3.x``Windows` 平台下的安装,其他版本操作类似可直接自行准备安装包安装,其他操作系统请自行百度。
1010

@@ -20,7 +20,7 @@ permalink: /jvvxy8eb/
2020

2121
## 2. 安装
2222

23-
说实话,Python是所有语言中安装起来最容易的了,没有之一。
23+
说实话,Python 是所有语言中安装起来最容易的了,没有之一。
2424

2525
双击运行安装程序,按如图所示操作
2626

@@ -46,17 +46,16 @@ permalink: /jvvxy8eb/
4646

4747
(1)打开cmd(按下Win+R,输入cmd,回车)
4848

49-
(2)输入python -V以及pip -V(注意有个空格,且V大写),看到如下图信息,即代表安装成功,并且环境变量添加成功。如果提示 `python不是内部或外部命令,也不是可运行程序或批处理文件` ,则说明**你在上一步打开安装程序的界面最底下的对勾没有勾选**请卸载重装或自行百度解决
49+
(2)输入 `python -V` 以及 `pip -V`(注意有个空格,且 V 大写),看到如下图信息,即代表安装成功,并且环境变量添加成功。如果提示 `python不是内部或外部命令,也不是可运行程序或批处理文件` ,则说明**你在上一步打开安装程序的界面最底下的对勾没有勾选**请卸载重装或自行搜索解决方案
5050

5151
![](images/image-4.png)
5252

5353
## 4. 更换 PyPI 镜像源
5454

55-
极力建议你在刚刚打开的 cmd 中执行如下代码:
55+
如果你的网络连接不能畅通无阻地访问国际互联网,极力建议你在刚刚打开的 cmd 中执行如下代码:
5656

5757
```powershell
5858
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
5959
```
60-
:::
6160

6261
这个代码是更改 PyPI 的默认下载源,往后讲到第三部分时会详细介绍。
Lines changed: 34 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,55 @@
11
---
22
copyright:
3-
author: 异想之旅 | YuzhenQin | 程家麒| Faceybr0
3+
author: 异想之旅 | YuzhenQin | 程家麒 | Faceybr0
44
permalink: /a9ud3a5f/
55
---
66

7-
# 写Python前须知
7+
# 写 Python 前须知
88

99
## 怎么写代码
1010

11-
首先我们讲一个常识性内容:
11+
首先我们讲一个常识性内容:**一个脑子没点大病的程序员不会用普通的文本编辑器写代码,不管是什么编程语言!**
1212

13-
**一个脑子没点大病的程序员不会用Windows自带的那个文本编辑器写代码,不管是H5还是Python还是其它语言!**
13+
一个好的编辑器可以帮助你完成以下工作:
1414

15-
那么我们就来说说你应该用什么编辑器:
15+
- 语法检查
16+
- 输入过程中的提示和补全
17+
- 文件目录快捷管理
18+
- 代码的运行和调试
19+
- Git(你以后应该会用到)
20+
- ...
1621

17-
身为一个现代人,我们需要学习使用**适合现代的编辑器(免费的):**[**Visual Studio Code**](https://code.visualstudio.com/)
18-
19-
Visual Studio Code (后文简称VSC)初次使用需要配置插件(插件商店搜索Python即可)以及Python本体的路径(也就是`python.exe`这个文件在你电脑上的位置),若遇到困难请自行百度解决。
20-
21-
除了VSC以外,对于Python而言还有[PyCharm](https://www.jetbrains.com/pycharm/)可以选择。
22-
23-
开发过程具体工具的使用请见下一节。
22+
[如何运行 Python 代码](/3aka4vaa/)一节中,我们将介绍[Visual Studio Code 的安装和使用](/3aka4vaa/#使用-visual-studio-code)。你也可以选择 PyCharm 等其它编辑器。
2423

2524
## 当我遇到不会的东西
2625

27-
在这里,我们推荐三个步骤**若是某一步直接得到了你想要的答案,那么你就可以不用进行下一步了**
26+
在这里,我们推荐三个步骤
2827

29-
1. **询问你的Bing/百度/Google/知乎/CSDN等**
30-
1. **查阅官方文档**
31-
1. **然后再去询问你的朋友,~~如果遇事直接问朋友请寻找一些低血压患者询问,因为这样可以改善他们的疾病状况~~**
28+
1. 使用搜索引擎搜索问题,注意包含**关键代码****报错信息**。我们**不推荐** Google 和 Bing 以外的搜索引擎。
29+
2. 查阅官方文档
30+
3. 询问你的朋友或者互联网上的其他人
31+
32+
::: note
33+
虽然我们鼓励你遇到问题时先尝试独立解决,但鉴于本文档为 Python 入门文档,我们欢迎你随时在评论区提问。
34+
:::
3235

3336
## 如何询问你的朋友
3437

3538
当你遇到报错的时候,请不要:
3639

37-
- 只截屏你出错的一句:有的时候啥用没有,最好能传到Git方便查看,或是找一个人然后代码直接压缩发他;
38-
- 只截屏报错:谁知道怎么改;
39-
- 不截屏报错+截屏代码:鬼知道你出了啥错,还不给复制粘贴,还要颅内运行检查报错;
40-
- 闲的没事干说一句:在吗,问个事 然后一个小时不说出了啥事,然后回一句“没事了”:可以治疗低血压。
40+
- 只分享你出错的一句代码:有的时候啥用没有
41+
- 只截屏报错:谁知道怎么改
42+
- 截屏代码但不截屏报错:截图不能复制粘贴就算了,还要颅内运行检查报错
43+
- 闲的没事干说一句“在吗,问个事”然后一个小时不说出了啥事,最后回一句“没事了”:可以治疗低血压
44+
45+
请你尽可能详细地分享:
46+
47+
- 报错信息
48+
- 完整代码
49+
- 对于单文件问题,请直接发送代码文件
50+
- 对于多个文件的项目,请使用 Git 或压缩文件
51+
- 如果项目规模较大,你应当尽可能给出最小复现样例
52+
- 你已经尝试过的解决方案
53+
- 你找到的可能有用的互联网信息
4154

42-
当两个人都方便的时候,**远程控制**是一个十分方便有效的解决问题方式,力推腾讯会议
55+
当两个人都方便的时候,**远程控制**是一个十分方便有效的解决问题方式。

docs/0 前言/0.5 如何运行Python代码.md

Lines changed: 59 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -4,129 +4,147 @@ copyright:
44
permalink: /3aka4vaa/
55
---
66

7-
# 如何运行Python代码
7+
# 如何运行 Python 代码
88

99
::: warning
1010
本节方法主要针对 Windows 用户。
1111
:::
1212

1313
无论采用下面所介绍的哪一种运行方式,你都需要在电脑上安装好 Python 环境,具体可以参考前面几节的内容。
1414

15-
## 交互式运行
15+
## 交互式运行(即IDLE)
1616

1717
### 第一步,打开电脑的命令行工具
1818

19-
Windows 打开方式:按下`Win + R`组合键,输入`powershell`,回车打开。
19+
Windows 打开方式:按下 `Win + R` 组合键,输入 `powershell`,回车打开。
2020

2121
![](images/image-5.png)
2222

2323
也可以使用Windows开始菜单搜索,也是可以的。
2424

2525
::: note
26-
快捷键:`Win + X`呼出的菜单中同样可以找到
26+
快捷键:`Win + X` 呼出的菜单中同样可以找到
2727
特别注意:win10菜单中显示的是“Windows PowerShell“,而win11菜单中显示的是“Windows 终端”
2828
![](images/image-6.png)
2929
:::
3030

31-
### 第二步,输入`python`或者是`python3`
31+
### 第二步,输入`python`Mac/Linux 则是 `python3`
3232

3333
即可进入**交互式终端 Python Shell**
3434

3535
![](images/image-7.png)
3636

37+
在这里输入代码和直接打开 IDLE 的效果是一样的。
38+
3739
### 第三步,书写代码
3840

39-
在这里输入的的代码每敲击一次回车就会被实时运行出来,可随时查看各个表达式的值——甚至不需要`print()`。缺点就是运行的代码不能保存。我们通常使用这一交互式终端测试 Python 语法或者学习新接触的库。
41+
在这里输入的的代码每敲击一次回车就会被实时运行出来,可随时查看各个表达式的值——甚至不需要 `print()`。缺点就是运行的代码不能保存。我们通常使用这一交互式终端测试 Python 语法或者学习新接触的库。
4042

4143
![](images/image-8.png)
4244

4345
### 退出 Python Shell
4446

45-
- 方式一:
46-
47-
快捷键 `Ctrl + Z`(可能需要回车)。
48-
49-
- 方式二:
50-
51-
手动在 Shell 中输入:`exit()` 后,回车执行命令
52-
53-
- 方式三:
54-
55-
看到这个黑框框右上角的那个叉叉了吗?对,点一下就行了。
47+
- 方式一:快捷键 `Ctrl + Z`(可能需要回车)。
48+
- 方式二:手动在 Shell 中输入:`exit()` 后,回车执行命令
49+
- 方式三:看到这个黑框框右上角的那个叉叉了吗?对,点一下就行了。
5650

5751
### 另一种方式:Python IDLE
5852

59-
你可以直接在Windows的开始菜单中找到它。点击后,你会得到一个可交互运行的窗口,使用方式与 Python Shell 无二。
53+
通常情况下,你可以直接在 Windows 的开始菜单或 Mac 的启动台中找到它。点击后,你会得到一个可交互运行的窗口,使用方式与 Python Shell 无二。
6054

6155
![](images/image-9.png)
6256

6357
## 运行 Python 文件
6458

6559
### 第一步,还是打开命令行工具
6660

67-
### 第二步,`cd`切换到`.py`文件所在的目录
61+
### 第二步,`cd` 切换到 `.py` 文件所在的目录
6862

69-
在 cmd 中,如果文件不在 C 盘,可能需要我们`cd`后再切换一次:
63+
在每一行开头处、`>` 符号前会显示一个你电脑中的文件夹路径,这是当前命令行的工作目录。我们需要使用 `cd` 命令切换到存放 Python 文件的目录下。
7064

71-
![](images/image-10.png)
65+
在 cmd 中,如果文件不在 C 盘,可能需要我们 `cd` 后再切换一次:
7266

67+
![](images/image-10.png)
7368

74-
亦或者,直接在 Windows 文件资源管理器地址栏单机空白区域,输入`cmd``Power Shell` (下图以cmd做演示) ,然后回车:
69+
亦或者,直接在 Windows 文件资源管理器地址栏单机空白区域,输入 `cmd`下图以cmd做演示,然后回车:
7570

7671
![](images/20220728-222903Edit.gif)
7772

7873
::: note
79-
此时唤出的CMD命令行的目录已经处于当前文件夹下
74+
此时唤出的 CMD 命令行的工作目录已经处于当前文件夹下
8075
:::
8176

8277
## 使用 Visual Studio Code
8378

84-
这才是我们运行 Python 文件通常的方式
79+
Visual Studio Code 是一款较为流行和专业的代码编辑器。通过安装插件,你可以使用 Visual Studio Code 完成许多语言的开发
8580

8681
### 首先从官网下载安装
8782

8883
[Visual Studio Code - Code Editing. Redefined](https://code.visualstudio.com/)
8984

9085
::: note
91-
网信办为了保护我国脆弱的人民似乎把这个网站也墙掉了,访问极不稳定。
86+
网信办为了保护我国脆弱的人民似乎把这个网站也墙掉了,访问极不稳定。如果你是 Windows,可以使用[此链接](https://sw.pcmgr.qq.com/a6518ae2056ff6810c6a8b508e95f3cf/68e3b2b3/spcmgr/download/VSCodeUserSetup-x64-1.99.3.exe)下载(更新时间:2025-04-18)。
9287
:::
9388

9489
### 打开软件,安装插件
9590

96-
使用`Ctrl + Shift + X`打开插件安装界面。推荐安装如下内容:
91+
使用 `Ctrl + Shift + X`(Mac 为`command + shift + X`打开插件安装界面。推荐安装如下内容:
9792

98-
- `Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code`:中文语言包
99-
- `Python`:对 Python 语言的较完整支持
100-
- `Code Runner`:代码运行插件
93+
- **Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code**:中文语言包,安装后需根据软件右下角的提示切换语言
94+
- **Python**:对 Python 语言的较完整支持。**请认准发布者为 Microsoft、名称为且仅为 Python 的插件**
95+
- **Code Runner**:代码运行插件
96+
- **yapf**(本人使用)或 **Black Formatter**(更流行):Python 代码格式化插件,使你的代码阅读起来更舒服。安装后,可以在打开任何 Python 文件后使用快捷键 `Shift + Alt + F`(Mac 为`shift + option + F`)来使用。
10197

10298
### 必要的设置
10399

104-
针对`Code Runner`需要做一些配置:按下快捷键`Ctrl + ,`打开设置界面,在搜索框输入`Code-runner: Run In Terminal`,勾选前面的对勾(如果找不到这一个设置项,请重启软件):
100+
按下快捷键 `Ctrl + ,`(Mac 为`command + ,`)即可打开设置界面。你也可以通过左下角的按钮进入。
101+
102+
#### 字体大小
103+
104+
在设置中第一位的 `Editor: Font Size` 用于控制代码书写时的字体大小。通常设置为 17-19 较为合适。
105+
106+
在上方搜索框输入 `terminal.integrated.fontSize`,将对应设置调整为 16(这是我推荐的数值,稍后你知道终端是什么以后可以根据自己喜好修改)。
107+
108+
#### Code Runner 配置
109+
110+
在搜索框输入 `Code-runner: Run In Terminal`,勾选前面的对勾(如果找不到这一个设置项,请重启软件):
105111

106112
![](images/image-11.png)
107113

108-
设置中还有关于编辑器字体大小的配置,可自行按需调整。
114+
此设置用于指定在终端中运行 Python 程序,方便学习终端的使用和使用 input 函数。
115+
116+
::: details Mac 用户需要配置的 Code Runner 选项
117+
Code Runner 默认使用 `python` 命令来运行程序。而在 Mac 上,通常需要输入 `python3` 才能正常找到 Python 解释器。因此,我们需要进行特别设置。
118+
119+
在设置界面(打开方式见上文),点击右上角的按钮打开配置文件。
120+
121+
![](images/image-14.png)
122+
123+
找到 `code-runner.executorMap`,再在其中找到 `python`,将后面的 `python -u` 更改为 `python3 -u`
124+
125+
![](images/image-15.png)
126+
:::
109127

110128
### 新建代码文件,编辑好后保存运行
111129

112-
可以点击右上角的运行按钮或者按下快捷键`Ctrl + Alt + N`推荐;Mac为`control + option + N`)。如果你的运行按钮如下图所示,有一个爬虫的角标:
130+
可以点击右上角的运行按钮或者按下快捷键 `Ctrl + Alt + N`(Mac为`control + option + N`)。
113131

114-
![](images/image-12.png)
132+
如果你的运行按钮如下图所示,有一个爬虫的角标,请先点击下拉三角,再选择 Run Code 选项。
115133

116-
请点击下拉三角,选择`Run Code`选项。
134+
![](images/image-12.png)
117135

118136
代码文件将在下方的终端运行出来。
119137

120138
![](images/image-13.png)
121139

122-
请一定记得**先保存再运行代码**如果你的代码有用到`input`函数,请先**用鼠标在图中箭头位置单击**以选定焦点位置,再进行输入。
140+
如果你的代码有用到 `input` 函数获取用户输入,请先**用鼠标在图中箭头位置单击**以选定焦点位置,再进行输入。
123141

124-
::: tip
125-
另一个小技巧:你可以在顶部菜单的“文件”中找到“自动保存”并勾选。
126-
:::
142+
请一定记得**先保存再运行代码**(快捷键为 `Ctrl + S``command + S`)。你也可以在顶部菜单的“文件”中找到“自动保存”并勾选。
127143

128-
Windows下的 VSC 终端就是一个 CMD 或 PowerShell (上图红框中为PowerShell),你也可以直接在里面写你要执行的命令。默认情况下打开的是一个 PowerShell 。
144+
::: note
145+
Windows 下,Visual Studio Code 打开的终端就是一个 CMD 或 PowerShell (上图红框中为PowerShell),你也可以直接在里面写你要执行的命令。默认情况下打开的是一个 PowerShell 。
146+
:::
129147

130-
::: warning
148+
<!-- ::: warning
131149
对于Windows用户,**PowerShell 和 CMD 在命令语法上有些许区别,请务必注意区分!**
132-
:::
150+
::: -->

docs/0 前言/images/image-14.png

231 KB
Loading

docs/0 前言/images/image-15.png

180 KB
Loading

docs/6 附录/6.3 引用的互联网资源.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ permalink: /fijhd6jw/
1818
- [字符串_百度百科](https://baike.baidu.com/item/%E5%AD%97%E7%AC%A6%E4%B8%B2)
1919
- [转义字符_百度百科](https://baike.baidu.com/item/%E8%BD%AC%E4%B9%89%E5%AD%97%E7%AC%A6)
2020
- [Hash(散列函数)_百度百科](https://baike.baidu.com/item/Hash/390310)
21-
- [维基百科](https://zh.wikipedia.org/zh-cn/)
21+
- [维基百科](https://zh.wikipedia.org/zh-cn/)(访问需要接入国际互联网)
2222
- [类型转换 - 维基百科,自由的百科全书](https://zh.wikipedia.org/zh-cn/%E7%B1%BB%E5%9E%8B%E8%BD%AC%E6%8D%A2)
2323
- [对象 (计算机科学) - 维基百科,自由的百科全书](<https://zh.wikipedia.org/wiki/%E5%AF%B9%E8%B1%A1_(%E8%AE%A1%E7%AE%97%E6%9C%BA%E7%A7%91%E5%AD%A6)>)
2424
- [菜鸟教程(runoob.com)](https://www.runoob.com/)
@@ -38,7 +38,7 @@ permalink: /fijhd6jw/
3838
- [Python 类型注解(Type Hints) | 菜鸟教程](https://www.runoob.com/python3/python-type-hints.html)
3939
- [菜鸟教程(cainiaojc.com)](https://www.cainiaojc.com/)
4040
- [Python 日期时间(datetime) - 菜鸟教程](https://www.cainiaojc.com/python/python-datetime.html)
41-
- [w3cschool](https://www.w3cschool.cn/)
41+
- [编程狮](https://www.w3cschool.cn/)
4242
- [Python文件基本操作整理 | w3c笔记](https://www.w3cschool.cn/article/25704283.html)
4343
- [CSDN](https://www.csdn.net/)
4444
- [什么是形式参数?什么是实际参数_戴耳机的皮皮熊的博客-CSDN博客_形式参数](https://blog.csdn.net/sssnmnmjmf/article/details/68942239)
@@ -48,10 +48,13 @@ permalink: /fijhd6jw/
4848
- [Python常用魔术方法 - 知乎](https://zhuanlan.zhihu.com/p/329962624)
4949
- [如何理解python中一切皆对象呢?看type,object,class的关系 - 知乎](https://zhuanlan.zhihu.com/p/100885824)
5050
- [python路径操作新标准:pathlib 模块 - 知乎](https://zhuanlan.zhihu.com/p/139783331)
51-
- [掘金](https://juejin.cn/)
51+
- [稀土掘金](https://juejin.cn/)
5252
- [彻底搞懂Python一切皆对象!!! - 掘金](https://juejin.cn/post/6844903858599100424)
5353
- [博客园](https://www.cnblogs.com/)
5454
- [python格式化输出之format用法 - lovejh - 博客园](https://www.cnblogs.com/lovejh/p/9201219.html)
55+
- [腾讯软件中心](https://pc.qq.com/)
56+
- [【Python下载】2025年最新官方正式版Python 免费下载 - 腾讯软件中心官网](https://pc.qq.com/detail/5/detail_24685.html)
57+
- [【Visual Studio Code下载】2025年最新官方正式版Visual Studio Code 免费下载 - 腾讯软件中心官网](https://pc.qq.com/detail/16/detail_22856.html)
5558
- 其它
5659
- [ pypi | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror](https://mirrors.tuna.tsinghua.edu.cn/help/pypi/)
5760
- [httpbin.org](https://httpbin.org/)

0 commit comments

Comments
 (0)