Python 学习笔记 1：环境准备与第一个 Python 程序

一、背景

这篇文章开始整理之前学习 Python 时留下的一些代码记录。

第一篇先不展开复杂语法，只解决几个最基础的问题：

1. Python 程序怎么运行
2. 第一个 Python 程序怎么写
3. print() 是什么
4. 注释怎么写
5. if __name__ == '__main__' 是什么

对应的练习代码主要是：

00hello.py
01第一个Python程序.py

学习 Python 时，不建议一开始就直接上复杂项目。先把解释器、文件执行、输出、注释这些基础点跑通，后面的变量、数据类型、流程控制才好继续展开。

二、环境准备

1. 安装 Python

Python 程序需要通过 Python 解释器执行，所以第一步是先确认本机已经安装 Python。

可以在终端中执行：

python --version

或者：

python3 --version

如果能看到类似下面的输出，就说明 Python 已经安装成功：

Python 3.10.13

不同机器上命令可能不一样：

命令	说明
python	有些系统中指向 Python 3，也可能指向 Python 2
python3	通常明确表示 Python 3
pip	Python 包管理工具
pip3	Python 3 对应的包管理工具

如果是在 macOS 或 Linux 上学习，建议优先使用：

python3
pip3

2. 选择代码编辑工具

写 Python 代码可以使用很多工具，例如：

• PyCharm
• VS Code
• Sublime Text
• Vim

如果是刚开始学习，使用 PyCharm 或 VS Code 都可以。关键不是工具本身，而是要先搞清楚：

编辑器负责写代码
Python 解释器负责执行代码

也就是说，.py 文件只是文本文件，真正运行它的是 Python 解释器。

3. 创建 Python 文件

Python 文件一般以 .py 结尾，例如：

hello.py

文件名建议使用英文、数字、下划线，不建议一开始就使用空格或特殊符号。

例如：

hello.py
first_python.py
python_demo_01.py

三、第一个 Python 程序

最简单的 Python 程序就是输出一句话：

print("hello,python")

保存为：

hello.py

然后在终端中执行：

python3 hello.py

输出结果：

hello,python

这里的 print() 是 Python 的内置函数，用来将内容输出到控制台。

四、print 输出

print() 可以输出字符串，也可以输出变量、列表等内容。

例如：

print("hello,python")

nums = [1, 2, 3, 4, 5]
print(nums)

输出结果：

hello,python
[1, 2, 3, 4, 5]

这里有两个点需要注意：

1. 字符串需要使用引号包起来
2. print() 可以输出不同类型的数据

字符串既可以使用双引号，也可以使用单引号：

print("hello")
print('python')

这两种写法都可以。

五、Python 注释

注释是写给人看的说明文字，Python 解释器不会执行注释内容。

1. 单行注释

单行注释使用 #：

# 输出一行文本
print("hello,python")

# 后面的内容不会被执行。

2. 多行注释

多行说明可以使用三引号：

'''
这里是一段说明文字
可以写多行
'''

也可以使用三个双引号：

"""
这里也是一段多行说明
"""

刚开始学习时，注释可以多写一点，帮助自己理解代码。

但是后面写真实代码时，不建议每一行都写重复注释。比较好的注释应该解释“为什么这么写”，而不是简单重复代码本身。

六、程序入口写法

在练习代码中还有一种常见写法：

if __name__ == '__main__':
    print("hello,python ！")

这段代码可以先这样理解：

只有当前文件被直接运行时，下面的代码才会执行。

例如有一个文件：

def say_hello():
    print("hello,python")


if __name__ == '__main__':
    say_hello()

当我们直接执行这个文件时：

python3 hello.py

会执行：

say_hello()

这类写法在 Python 中很常见，后面学习函数、模块导入时会更加重要。

这一篇先不深入展开它的原理，只需要先记住：

写在 if __name__ == '__main__': 下面的代码，通常是当前文件的启动入口。

七、常见问题

1. python 和 python3 有什么区别

有些系统中：

python

可能指向 Python 2，也可能指向 Python 3。

而：

python3

通常明确表示 Python 3。

学习新代码时，建议使用 Python 3。

2. 运行文件提示 command not found

如果执行：

python3 --version

提示命令不存在，说明 Python 没有安装，或者环境变量没有配置好。

可以先确认 Python 安装路径，或者重新安装 Python。

3. 文件名不要和模块名冲突

不要把文件命名成：

json.py
time.py
random.py

这些名字和 Python 标准库模块重名，后面导入模块时可能出现奇怪的问题。

刚开始可以使用：

demo01.py
hello.py
first_python.py

八、本篇总结

这篇文章主要完成 Python 学习的第一步：

1. 确认 Python 环境是否可用
2. 创建并运行 .py 文件
3. 使用 print() 输出内容
4. 学习单行注释和多行注释
5. 初步认识 if __name__ == '__main__'

第一个程序本身很简单，但它解决的是学习 Python 的入口问题。

只要能够正常运行：

print("hello,python")

后面就可以继续学习变量、数据类型、运算符和流程控制了。