Python编程基础：markdown语法与环境搭建

原创已于 2025-06-07 13:19:59 修改 · 631 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#笔记 #python

于 2025-06-07 13:18:46 首次发布

一、文档与工具介绍（Markdown与Typora）

Markdown笔记语法：
- 一种内置语法的文档格式，学会后可高效编写格式化笔记。
- 常见语法：
  - 一级标题：# + 空格 + 标题内容。
  - 二级标题：## + 空格 + 标题内容（以此类推，最多六级）。
  - 列表：- + 空格 + 内容或 1. + 空格 + 内容（自动编号）。
  - 嵌套列表：在列表项后按Tab键缩进，Shift+Tab取消缩进。
  - 代码块： 切换英文输入法，输入三个反引号（```）后回车。可在代码块内选择语言进行高亮显示（如python）。
  - 表格：可使用菜单栏“段落”->“插入表格”快捷生成。
- 标题序号注意事项： 若标题需要序号，如## 1.内容，数字与内容之间不加空格，以免与列表语法冲突。
Typora工具：
- 功能： 支持Markdown语法的笔记编辑工具，所见即所得，编辑时即时显示效果。
- 首次使用配置：
  - 显示侧边栏： 点击左下角圆点，选择“显示或隐藏侧边栏”，以便查看大纲和文件视图（建议切换为文件列表竖视图，方便管理）。
  - 图片保存路径配置（仅需配置一次）：
    - 点击“文件”->“偏好设置”->“图像”。
    - 选择“复制到指定文件夹”（选择“./assets”）。
    - 勾选“优先使用相对路径”。
    - 目的： 确保粘贴的图片自动复制到项目文件所在目录的assets文件夹内，方便分享和管理整个项目文件夹。
- 重要习惯：新建文件后务必先保存到指定项目目录，再开始编写笔记，避免图片等资源存储在临时目录，导致文件分享后图片丢失。

二、环境搭建

为了正常开发Python代码并安装第三方模块，需先安装Python解释器，并配置相关工具。

Python解释器安装：
- 作用： 将你编写的Python代码解释成计算机能理解的语言（如汇编、0101），才能被计算机执行。
- 版本选择：
  - 目前主流版本为Python 3.x系列。
  - 自行下载： 可访问Python官网(python.org)下载对应版本。
  - 旧版本共存： 如电脑已有旧版本Python，可保留，但需明确其安装路径。
- 安装步骤（以Windows为例，3.8版本演示）：
  1. 双击安装包。
  2. 重要： 勾选 Add Python 3.x to PATH (自动配置环境变量)。
  3. 选择 Customize installation (自定义安装)。
  4. 下一页默认勾选即可，点击 Next。
  5. 重要： 勾选 Install for all users。
  6. 修改安装路径： 建议自定义安装到类似 C:\Python38 (若3.9则为C:\Python39) 这样的简洁目录。
  7. 点击 Install，等待安装成功。
- Python解释器核心目录说明：
  - 安装目录 (如 C:\Python39 )：包含 python.exe (解释器本体)。
  - Scripts 目录： 包含 pip.exe (第三方包管理工具)。
  - Lib 目录： 包含Python内置模块（如random.py）。
  - Lib\site-packages 目录：pip安装的第三方包（如requests、django）的存放位置。
- Python代码文件后缀： 统一使用 .py 作为Python代码文件的后缀名。
测试Python解释器：
- 目的： 验证解释器是否能成功运行Python代码。
- 步骤：
  1. 编写一个简单的 .py 文件（如 code.py），内容为 print("Hello World")。
  2. 打开命令行终端 (CMD)。
  3. 执行命令：C:\Python39\python.exe C:\path\to\your\code.py (替换为你的实际路径)。
  4. 若输出“Hello World”，则表示解释器运行成功。
- 文件扩展名显示： 建议在文件管理器中显示文件扩展名（取消勾选“隐藏已知文件类型的扩展名”）。
pip 工具安装与测试：
- 作用： 用于安装和管理Python的第三方模块（库）。
- 原理：pip 从PyPI (Python Package Index) 网站下载模块。
- 国内加速源（推荐）： 默认PyPI下载速度较慢，建议配置国内镜像源加速，如豆瓣源。
- 配置豆瓣源：
  1. 打开命令行终端。
  2. 执行命令：C:\Python39\Scripts\pip.exe config set global.index-url https://pypi.doubanio.com/simple/ (替换为你的实际路径)。
- 安装第三方包测试：
  1. 打开命令行终端。
  2. 执行命令：C:\Python39\Scripts\pip.exe install requests (替换为你的实际路径)。
  3. 若显示 Successfully installed requests...，则表示pip安装成功。
  4. 注意： 安装过程中可能出现警告信息（如pip版本过旧），无需理会，不影响使用。
环境变量配置：
- 作用： 简化命令行操作，无需每次输入Python解释器和pip工具的完整路径。
- 配置后效果： 直接在CMD中输入 python your_code.py 或 pip install module_name 即可。
- 配置方法：
  1. 右键“此电脑”->“属性”->“高级系统设置”->“环境变量”。
  2. 在“系统变量”下找到 Path，点击“编辑”。
  3. 添加Python安装目录和其下Scripts目录的路径（如 C:\Python39 和 C:\Python39\Scripts）。
  4. 点击“确定”保存。
- 生效： 配置后需关闭并重新打开命令行终端才能生效。
- 注意事项：
  - 路径大小写需准确，建议直接复制文件夹路径。
  - 若之前安装过Python，建议清理Path环境变量中旧版本的相关路径，避免冲突。
- 测试： 重新打开CMD，执行 pip install flask，验证是否能直接安装。

三、PyCharm IDE安装与使用

PyCharm介绍：
- 类型： 集成开发环境 (IDE)，是功能强大的代码编辑器，用于方便编写、运行Python代码。
- 版本：
  - 社区版 (Community)： 免费，前期学习足够。
  - 专业版 (Professional)： 收费，功能更强大，后期项目开发会用到。
- 建议： 建议都安装，两者可同时共存。前期先安装社区版。
- 下载： 访问PyCharm官网，选择对应系统和版本下载（建议先下载社区版）。
- 安装： 一路Next即可，无需特殊配置。
PyCharm首次打开与项目创建：
- 首次打开： 可能会提示导入设置、接受用户许可，选择不导入，并接受许可。可选择主题（暗色/亮色），直接跳过即可。
- 创建新项目：
  1. 点击 Create New Project。
  2. 设置项目路径： 选择一个新文件夹作为项目目录（如 D:\my_python_projects\d01），不要与Python解释器安装目录混淆。
  3. 选择Python解释器： 确保下方“Python Interpreter”选择的是你已安装的Python解释器路径（如 C:\Python39\python.exe）。如果未自动识别，点击齿轮图标，选择 System Interpreter 或手动查找。
  4. 重要： 确保取消勾选“Create a main.py welcome script”。
  5. 点击 Create。
PyCharm编写与运行代码：
- 创建Python文件： 在左侧项目视图中，右键项目名 -> New -> Python File，输入文件名（如 demo）。
- 编写代码： 在新创建的 demo.py 文件中，输入 print("Hello World")。PyCharm会提供智能提示。
- 运行代码： 右键 demo.py 文件 -> Run 'demo'。
- 查看结果： PyCharm下方会显示运行结果，其本质与在CMD中手动调用解释器运行代码相同。