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
分数: 95console.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 代替正式错误处理。
实际项目中,调试完成后应清理临时日志,并保留能够帮助后续维护者理解业务逻辑的关键注释。
按自己的节奏,确认真正理解。