JavaScript / TypeScript / 系统课时

使用控制台输出与注释

使用控制台输出与注释

本篇解决 JavaScript 开发初期如何观察程序运行结果和记录代码说明的问题。你将学习常用 console 方法,以及单行注释、多行注释在调试和维护代码中的使用方式。

学习目标

  • 掌握 console 常用输出方法并理解区别
  • 学会使用注释说明代码意图
  • 能利用控制台快速验证 JavaScript 执行结果

使用 console 输出程序信息

浏览器提供了开发者工具中的 Console 面板,用于查看 JavaScript 输出、错误信息和调试数据。最常用的方法是 console.log。

javascript
const username = 'Alice';
const score = 95;

console.log('用户名:', username);
console.log('分数:', score);

预期输出

text
用户名: Alice
分数: 95

console.log 适合输出普通运行状态,例如检查变量值、确认函数是否执行。

使用不同级别的控制台方法

除了普通日志,console 还提供了用于不同场景的方法。

javascript
console.info('应用启动');
console.warn('配置即将过期');
console.error('请求失败');

预期输出

text
应用启动
配置即将过期
请求失败

在浏览器开发工具中,不同级别的信息通常会使用不同图标显示,方便快速定位问题。

查看对象和表格数据

开发过程中经常需要观察对象结构。console.table 可以将数组或对象显示为表格形式。

javascript
const users = [
  { name: 'Tom', age: 20 },
  { name: 'Jane', age: 22 }
];

console.table(users);

预期输出

text
┌─────────┬────────┬─────┐
│ (index) │ name   │ age │
├─────────┼────────┼─────┤
│ 0       │ Tom    │ 20  │
│ 1       │ Jane   │ 22  │
└─────────┴────────┴─────┘

实际显示格式会根据浏览器开发工具版本略有不同,但数据内容保持一致。

使用单行和多行注释

注释不会被 JavaScript 执行,用于解释代码目的、记录临时调试信息或提醒维护者注意事项。

单行注释使用两个斜杠:

javascript
// 保存用户登录状态
const loggedIn = true;

多行注释使用斜杠和星号组合:

javascript
/*
  初始化页面数据
  后续会根据接口结果更新内容
*/
function initPage() {
  console.log('页面初始化');
}

预期输出

text
页面初始化

调试时合理使用输出和注释

console 输出适合观察动态运行结果,注释适合解释代码为什么这样设计。不要把大量无意义的注释写进代码,也不要依赖 console.log 代替正式错误处理。

实际项目中,调试完成后应清理临时日志,并保留能够帮助后续维护者理解业务逻辑的关键注释。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用控制台输出与注释

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通