Skip to content

Commit 02cee54

Browse files
author
sky.sun
committed
doc:基础概念
1 parent 3aecdbf commit 02cee54

File tree

1 file changed

+48
-5
lines changed

1 file changed

+48
-5
lines changed

docs/guide/syntax.md

Lines changed: 48 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,48 @@ print("交换后:", a, b)
126126

127127
**关于常量的约定**:虽然 Python 没有`const`关键字,但社区约定使用全大写的变量名来表示常量,比如`MAX_SIZE = 100``PI = 3.14159`。这是一个约定俗成的规则,虽然这些"常量"在技术上仍然可以被修改。
128128

129+
## 函数调用基础
130+
131+
在深入学习 Python 各种数据类型之前,我们需要了解函数调用的基本语法。函数是一段可重复使用的代码块,就像 JavaScript 一样,Python 也大量使用函数。
132+
133+
### 位置参数
134+
135+
JavaScript 中按位置顺序传递参数:
136+
137+
```javascript runner
138+
// JavaScript 位置参数
139+
console.log("Hello World!"); // 传入单个参数
140+
console.log("姓名:", "张三"); // 传入多个参数
141+
"hello".toUpperCase(); // 无参数调用
142+
```
143+
144+
Python 的位置参数语法几乎相同:
145+
146+
```python runner
147+
# Python 位置参数
148+
print("Hello World!") # 传入单个参数
149+
print("姓名:", "张三") # 传入多个参数
150+
"hello".upper() # 无参数调用
151+
```
152+
153+
### 关键字参数
154+
155+
Python 函数还支持关键字参数,即通过参数名指定值的参数:
156+
157+
```python runner
158+
# 关键字参数:通过参数名指定
159+
print("苹果", "香蕉", "樱桃", sep="-") # sep 指定分隔符
160+
print("第一行", end="") # end 指定结尾字符
161+
print("第二行")
162+
163+
# 后续章节会遇到的例子
164+
my_list = [3, 2, 4, 1, 5]
165+
sorted_list = sorted(my_list, reverse=True) # reverse 是关键字参数
166+
print("降序排列:", sorted_list)
167+
```
168+
169+
这种语法让函数调用更加灵活和可读。我们会在专门的函数章节中详细学习如何定义和使用函数,现在只需要理解如何调用已有的函数即可。
170+
129171
## 命名规范
130172

131173
JavaScript 社区广泛采用驼峰式命名(camelCase)作为变量命名规范,这已经成为前端开发的标准:
@@ -363,10 +405,11 @@ Python 基础语法概念体现了"优雅胜过丑陋,明了胜过晦涩"的
363405

364406
1. **缩进定义代码块**:使用 4 个空格缩进,强制保持代码整洁,提高可读性
365407
2. **变量赋值简洁**:无需声明关键字,直接赋值创建变量,支持多重赋值和元组解包
366-
3. **命名规范统一**:采用 snake_case 蛇形式命名,不同类型标识符有不同约定,与内置方法的历史驼峰命名共存
367-
4. **注释系统丰富**`#`号单行注释,docstring 文档字符串提供运行时可访问的文档
368-
5. **语句结束清晰**:换行即表示语句结束,必要时可用反斜杠或括号进行续行
369-
6. **文档字符串特色**:三重引号 docstring 是语言内置特性,支持运行时访问和工具生成文档
408+
3. **函数调用简单**:除了 JavaScript 那样的位置参数外,还支持关键字参数,更加灵活可读
409+
4. **命名规范统一**:采用 snake_case 蛇形式命名,不同类型标识符有不同约定,与内置方法的历史驼峰命名共存
410+
5. **注释系统丰富**`#`号单行注释,docstring 文档字符串提供运行时可访问的文档
411+
6. **语句结束清晰**:换行即表示语句结束,必要时可用反斜杠或括号进行续行
412+
7. **文档字符串特色**:三重引号 docstring 是语言内置特性,支持运行时访问和工具生成文档
370413

371-
Python 的设计哲学强制开发者编写整洁、可读的代码,这种"约束"实际上提高了代码质量和团队协作效率。掌握这些基础语法概念,是编写优秀 Python 代码的第一步
414+
Python 的设计哲学强制开发者编写整洁、可读的代码,这种"约束"实际上提高了代码质量和团队协作效率。掌握这些基础语法概念,特别是函数调用的基本语法,为后续学习各种数据类型和操作打下了坚实基础
372415

0 commit comments

Comments
 (0)