TRAE 基础操作指南

一、先认识 TRAE 的界面

TRAE 是一个带 AI 助手的代码编辑器：左边管理文件，中间写代码，右边随时能问 AI。 第一次打开会觉得东西有点多，其实只要认清下面四个区域，就够用了。

底部还有一块终端（Terminal），是直接给电脑下命令的地方， 运行脚本、安装库都在这里，第五节会讲怎么打开它。

二、打开文件夹：TRAE 以项目为单位

TRAE 不像 IDLE 那样一次只开一个文件，它是以文件夹为单位工作的： 打开一个文件夹，就等于打开一个项目，左侧文件树里显示的就是这个文件夹里的全部内容。

1. 点菜单 文件 → 打开文件夹；
2. 在弹出的窗口里选中你要用的文件夹（例如桌面上新建的 python_study）；
3. 左侧文件资源管理器里就会出现这个文件夹里的文件，可以逐层展开。

三、新建并运行 .py 文件

1. 新建文件

在左侧文件资源管理器里，右键目标文件夹 → 选 新建文件， 然后输入文件名，以 .py 结尾，例如 hello.py。

2. 写一行代码

print("第一次用 TRAE 写代码，成功！")

写完后按 Ctrl + S 保存（文件名后面的小圆点消失，就说明存好了）。

3. 运行它

最省事的办法是点编辑区右上角的 ▷ 运行按钮；也可以打开终端，敲命令运行。

运行成功后，输出会显示在下方终端或输出面板里：

第一次用 TRAE 写代码，成功！

用终端运行，就是先进入文件所在的文件夹，再用 python 加上文件名：

python hello.py

四、新建 .ipynb 文件

.ipynb 是 Jupyter Notebook 格式，它把代码切成一个个单元格， 可以逐格运行、逐格看结果，非常适合做数据分析和分步调试。

1. 同样在左侧资源管理器中右键目标文件夹；
2. 选 新建文件，文件名以 .ipynb 结尾，例如 analysis.ipynb；
3. TRAE 会自动把它识别为 Notebook，以单元格形式打开。

每个单元格单独运行：写完一格，按 Shift + Enter 运行它并跳到下一格。

五、高频快捷键一览

TRAE 用的快捷键和 VS Code 是同一套。下面这些键位不是凭印象写的， 都是从本机安装的 TRAE 键盘映射表里逐条核对过的。 想看全部，点「文件 → 首选项 → 键盘快捷方式」就能打开完整清单。

1. 先记住这四个

2. 注释与缩进（写 Python 每天都用）

这一组是新手最容易漏掉、却最省时间的。Python 靠缩进表示代码层级， 所以「整块缩进 / 取消缩进」和「整块注释」几乎天天要用。

3. 整行操作：移动、复制、删除

想调整几行代码的先后顺序，不用剪切再粘贴，直接挪就行。

4. 多光标：一次改很多处

用它改同名的变量特别快，比一个个找省太多时间。

5. 查找、跳转与其它实用键

六、把文件或代码添加到对话

想让 AI 看懂你正在处理的代码，最直接的办法就是「添加到对话」。它有两种常用方式。

方式一：选中代码添加

1. 在编辑器中选中一段代码；
2. 点悬浮菜单里的 添加到对话 按钮；
3. 所选内容会出现在 AI 对话框底部的输入框里，还带着文件名和行号。

比如选中这段：

def total_price(price, cups):
    return price * cups

方式二：用 # 符号添加

在 AI 对话框的输入框里输入 #，会弹出上下文选择面板， 可以挂上文件、文件夹、整个代码仓库，比复制粘贴更准确。

七、用 AI 给代码加注释

代码能跑通，但过两天自己都看不懂——这时让 AI 补注释最快。它有两种方式。

方式一：行内对话（推荐）

1. 选中需要加注释的代码；
2. 按 Ctrl + I 打开行内对话；
3. 输入 「为这段代码添加注释」；
4. AI 会在原地生成带注释的版本，你可以选择接受或继续修改。

方式二：侧边对话

1. 选中代码 → 点 添加到对话；
2. 在侧边对话框里输入 「为选中的代码生成行间注释」；
3. AI 会返回一份带注释的代码，你复制回去即可。

加注释之前：

def takeout_total(price, cups):
    return price * cups + 3

加注释之后（AI 生成的注释会以 # 开头）：

def takeout_total(price, cups):
    # 先算奶茶总价（单价 × 杯数），再加上 3 元打包费
    return price * cups + 3

八、用 AI 解释代码

遇到看不懂的代码，不用先自己硬啃——让 AI 讲一遍是最快的路径。

1. 选中要解释的代码片段；
2. 按 Ctrl + I 打开行内对话；
3. 输入 「解释这段代码的作用」 或 「这段代码在做什么」；
4. AI 会逐行或逐段把逻辑讲清楚。

比如这段：

spends = [12, 15, 9, 18]
total = sum(spends)
print(f"一周奶茶花了 {total} 元，平均每天 {total / len(spends):.1f} 元")

运行结果是：

一周奶茶花了 54 元，平均每天 13.5 元

让 AI 解释，它会告诉你：sum() 把列表里的数加起来、len() 数出有几个数、 f"..." 是格式化字符串、:.1f 表示保留一位小数。

九、用 AI 帮你排查报错

程序报错时，不要只把代码丢给 AI——把报错原文一起贴上，AI 才能对症下药。

假设你少写了一个右括号：

print("今天奶茶第二杯半价"

运行后终端里会出现：

  File "/Users/你的用户名/python_study/hello.py", line 1
    print("今天奶茶第二杯半价"
         ^
SyntaxError: '(' was never closed

正确的问法是：先选中报错的代码，按 Ctrl + I，然后把报错的最后一行也贴进去。比如可以这样问：

AI 会直接指出「左括号 ( 没有对应的右括号」，并把补好的代码给你。

十、常见问题

• 左侧文件树不见了：点最左侧活动栏的资源管理器图标即可展开，不用重装。
• 按 Ctrl + U 没有反应：快捷键要先让 TRAE 窗口处于激活状态（先点一下编辑区）； Mac 上是 Cmd + U。
• AI 的回答牛头不对马嘴：多半是它没看到你的代码。先选中代码 → 添加到对话再提问。
• 运行按钮点了没反应：先确认文件已保存、且右下角选的 Python 解释器是正确的那一个。
• 终端里 python 不认识：安装 Python 时没勾 Add python.exe to PATH，重装并勾上。
• .ipynb 单元格跑不起来：右上角还没选解释器（内核），选好就能运行。
• 文件的图标变成灰色：只是扩展名不认识，不影响内容；把后缀改成 .py 或 .ipynb 即可。

十一、随堂自测（16 题）

点击选项即可判分，答错的题会立刻显示解析。全部答完后会给出正确率和错题清单。