Cách đặt câu hỏi cho senior: nhanh có trả lời, không làm phiền

Cách đặt câu hỏi cho senior khi bị kẹt: khi nào nên hỏi, một tin nhắn đủ sáu phần để người đọc trả lời ngay, và script kiểm tra tin nhắn của Minh trước khi gửi.

Muốn nhanh có câu trả lời mà không làm phiền senior, hãy gửi một tin nhắn đủ để người đọc trả lời ngay mà không phải hỏi lại: bạn đang làm gì, lỗi nguyên văn, đã thử gì, và hỏi đúng một câu. Bạn có hay ngại hỏi như Minh không? Cùng mình xem nhé!

Ngại hỏi nên mất cả buổi chiều, có đáng không?

Ở bài trước, Minh đi làm tuần đầu và chạy được dự án. Đến chiều thứ Năm, 3/12/2026, một lỗi lạ xuất hiện khi chạy bài kiểm tra tự động, và Minh mất gần cả buổi chiều tự mò mà không hỏi ai, vì ngại làm phiền anh Phúc, người hướng dẫn, và sợ bị coi là chưa đủ giỏi. Minh là nhân vật minh họa của series này, nên mọi tên người, ngày tháng và lỗi trong bài là minh họa.

Lỗi đó trông thế này:

Lỗi Minh gặp khi chạy npm test (minh họa)
Error: getaddrinfo ENOTFOUND db
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (node:dns:107:26)

Dòng này nói máy không tìm thấy địa chỉ của một máy tên db. Trong dự án, db là tên của dịch vụ cơ sở dữ liệu trong Docker Compose, và tên đó chỉ dùng được giữa các container với nhau.

Minh chạy test trực tiếp trên máy, nên tên db không có nghĩa gì. Cách sửa là đổi host trong file .env.test thành localhost. Anh Phúc nhìn một cái là biết, mất khoảng một phút. Minh thì mất gần cả buổi chiều mà vẫn chưa ra.

Nhưng chuyện ngược lại cũng có thật: hỏi mà không chuẩn bị cũng tốn thời gian của người trả lời, và có thể còn tệ hơn vì làm người ta mất niềm tin rằng bạn đã cố. Mục tiêu của bài này là nằm đúng ở giữa: hỏi sớm đủ để không mất cả buổi chiều, và hỏi đủ rõ để người kia trả lời được ngay.

Khi nào nên hỏi, khi nào nên tự thử thêm?

Đây là quy tắc mình đề nghị Minh dùng. Nó là quy tắc của riêng mình, nhóm bạn có thể có thói quen khác, nên hãy xem nó là điểm bắt đầu để chỉnh.

Với yêu cầu chưa rõ, hãy hỏi trước khi bắt tay làm. Làm sai hướng cả ngày tốn hơn rất nhiều so với một câu hỏi lúc đầu, và đó thường không phải lỗi của bạn mà là yêu cầu mơ hồ.

Với lỗi kỹ thuật, hãy tự thử trước, nhưng có giới hạn thời gian. Mình đặt khoảng 30 phút, hoặc sớm hơn nếu bạn đã thử hai hướng khác nhau mà đều không ra. Con số 30 phút không phải chuẩn nào, nó chỉ để bạn có điểm dừng, vì người ngại hỏi thường không có điểm dừng nào cả. Với thứ có thể tra được trong năm phút ở README hoặc thư mục docs/, hãy tra trước.

Có một cách để việc này bớt cảm tính: dùng luôn cuốn nhật ký cuối ngày ở bài trước. Mẫu nhật ký có mục "Chưa hiểu (chưa hỏi ngay)" và mục "Đã thử trước khi hỏi". Khi một mục "chưa hiểu" bị kẹt quá giới hạn của bạn, bạn chuyển nó thành câu hỏi, và những gì đã ghi ở "đã thử" chính là nguyên liệu của tin nhắn. Các hướng dẫn đặt câu hỏi lâu đời của cộng đồng lập trình, như trang cách hỏi một câu hỏi hay của Stack Overflow và bài How To Ask Questions The Smart Way của Eric Raymond, cũng đều nhấn mạnh việc nói rõ bạn đã thử gì và đưa ra thông tin đủ để người khác tái hiện vấn đề.

Tin nhắn đầu tiên của Minh thiếu những gì?

Chiều đó, sau khi mất gần cả buổi, Minh gửi cho anh Phúc đúng một dòng. Mình lưu nó thành file để chấm điểm ở mục sau:

cau-hoi-xau.txt
Anh ơi, test em chạy không được, bị lỗi gì đó, anh xem giúp em với ạ

Hãy thử đặt mình vào anh Phúc đang làm việc của anh ấy. Đọc xong tin này, anh phải hỏi lại gần như mọi thứ. Dưới đây là cuộc trao đổi mà mình hình dung (minh họa), và mỗi lượt là một lần chờ:

Minh: Anh ơi, test em chạy không được, bị lỗi gì đó, anh xem giúp em với ạ

Anh Phúc: Lỗi gì em? Dán giúp anh nhé.

Minh: Dạ nó bảo ENOTFOUND gì đó ạ (gửi một ảnh chụp màn hình)

Anh Phúc: Em chạy lệnh gì, trên máy nào, đã thử gì chưa?

Bốn lượt, và đến giờ anh Phúc vẫn chưa biết gì ngoài việc có một lỗi mạng. Mỗi lượt như vậy là một lần anh phải bỏ việc đang làm, đọc, trả lời, rồi quay lại việc cũ, mà người ta thường cần một lúc để lấy lại mạch làm việc sau mỗi lần như thế. Nó còn để lại ấn tượng rằng Minh chưa thử gì, trong khi Minh đã thử khá nhiều. Cái sai không nằm ở việc hỏi, mà ở chỗ tin nhắn không chứa thông tin mà người trả lời cần.

Một tin nhắn dễ trả lời cần sáu phần

Cách mình hay nghĩ là: người đọc sẽ hỏi lại điều gì, thì đặt sẵn câu trả lời vào tin nhắn đầu. Sáu phần dưới đây là sáu câu hỏi lại mà anh Phúc phải hỏi ở trên.

  1. Bạn đang làm gì. Để người đọc hiểu mục tiêu, vì đôi khi câu trả lời đúng là "đừng làm cách đó".
  2. Lỗi hoặc kết quả nguyên văn. Hãy dán chữ, đừng chỉ chụp ảnh: chữ thì chép được, tìm được và đọc được trên điện thoại, còn ảnh thì không.
  3. Bạn mong đợi gì và thực tế ra sao. Hai thứ này cho biết "sai" nằm ở đâu.
  4. Bạn đã thử gì, ít nhất hai việc, kèm kết quả của từng việc. Nhờ đó người đọc không phải gợi ý lại những cách bạn đã loại.
  5. Môi trường: hệ điều hành, phiên bản công cụ, nhánh hoặc commit. Rất nhiều lỗi chỉ xảy ra ở một môi trường cụ thể.
  6. Một câu hỏi cụ thể ở cuối. "Anh xem giúp em" là một nhờ vả mơ hồ, còn "khi chạy test ngoài Docker thì host nên là gì" là một câu có thể trả lời bằng một dòng.

Sau khi đã tự thử, bạn có giả thuyết nào thì viết ra luôn. Giả thuyết đúng thì người đọc chỉ cần xác nhận, giả thuyết sai thì họ sửa nhanh hơn nhiều so với phải đoán bạn đang nghĩ gì.

Đây là tin nhắn Minh gửi sau khi viết lại. Nó dài hơn, và đọc xong anh Phúc có thể trả lời bằng một câu:

cau-hoi-tot.txt
Chào anh Phúc, em đang bị kẹt ở bước chạy test của dự án, anh xem giúp em một chút được không ạ?

Em đang chạy `npm test` để kiểm tra nhánh minh/them-ghi-chu trước khi gửi pull request.
Em mong đợi test chạy qua như trên CI, nhưng thực tế nó dừng ở lỗi này:

Error: getaddrinfo ENOTFOUND db
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (node:dns:107:26)

Em đã thử:
- Chạy lại `docker compose up -d db`, `docker ps` báo container đang Up.
- Xóa node_modules rồi `npm ci`, lỗi y như cũ.
- Tìm "ENOTFOUND db" trong README và thư mục docs/, chưa thấy.

Môi trường: Windows 11, Node 22.20.0, commit 4be71a2. File .env.test em tạo bằng cách chép từ .env.example.

Em nghi do .env.test, vì trong đó DATABASE_URL trỏ tới host "db" mà em chạy test ngoài Docker. Anh cho em hỏi: khi chạy test ngoài Docker thì host nên là gì ạ?

Hãy để ý hai thứ trong tin này. Dòng "File .env.test em tạo bằng cách chép từ .env.example" là thông tin Minh không nghĩ là quan trọng, nhưng chính nó dẫn tới nguyên nhân. Và phần "em nghi do .env.test" cho anh Phúc biết Minh đã nghĩ tới đâu. Câu trả lời có thể chỉ là: "Đúng rồi, đổi db thành localhost nhé."

Kiểm tra tin nhắn bằng một script nhỏ

Khi mình còn ngại và vội, mình hay quên một trong sáu phần. Vì vậy mình viết một script nhỏ kiểm tra tin nhắn trước khi gửi. Nó chỉ kiểm tra từng phần có mặt hay không, bằng từ khóa và hình dạng của chữ, chứ không đánh giá chất lượng. Bạn cần Node.js 22.18 trở lên, vì từ bản đó Node chạy thẳng file .ts, và không cần cài thêm gì. Cấu trúc thư mục:

Cấu trúc thư mục
dat-cau-hoi/
  package.json
  kiem-tra.ts
  cau-hoi-xau.txt
  cau-hoi-tot.txt
  mau-cau-hoi.txt
  src/kiem-tra-cau-hoi.ts
  src/kiem-tra-cau-hoi.test.ts
package.json
{
  "name": "hanh-trinh-junior-10",
  "private": true,
  "type": "module",
  "scripts": { "test": "node --test src" }
}

Hai file cau-hoi-xau.txt và cau-hoi-tot.txt là hai tin nhắn ở trên. Phần chính là danh sách sáu phép kiểm. Mỗi phép là một biểu thức chính quy nhỏ. Ví dụ phép "dán lỗi nguyên văn" tìm một dòng bắt đầu bằng Error, Exception, Traceback, fatal: hay npm ERR!, nên một lỗi chỉ được nhắc giữa câu ("em bị Error: ...") không tính:

src/kiem-tra-cau-hoi.ts
// Kiểm tra một tin nhắn hỏi đồng nghiệp có đủ sáu phần chưa. Chỉ kiểm tra SỰ CÓ MẶT của từng phần bằng từ khóa và hình dạng,
// không đánh giá chất lượng: tin nhắn nhồi từ khóa mà rỗng ruột vẫn qua (xem test cuối cùng).
export type Phep = { ten: string; dat: (tin: string) => boolean };

export const CAC_PHEP: Phep[] = [
  { ten: "nói đang làm gì", dat: (tin) => /(em|mình|tôi) đang (làm|chạy|cố|định|thử|viết|sửa)/iu.test(tin) },
  { ten: "dán lỗi nguyên văn", dat: (tin) => /^\s*(\w*Error\b|\w*Exception\b|Traceback|fatal:|npm ERR!)/m.test(tin) },
  { ten: "nói mong đợi và thực tế", dat: (tin) => /(mong đợi|kỳ vọng|đáng lẽ)/iu.test(tin) && /(thực tế|thay vì|nhưng)/iu.test(tin) },
  { ten: "nêu ít nhất hai việc đã thử", dat: (tin) => /đã thử/iu.test(tin) && (tin.match(/^\s*(?:[-*]|\d+\.)\s+\S/gmu) ?? []).length >= 2 },
  { ten: "cho biết môi trường", dat: (tin) => /(windows|macos|linux)/iu.test(tin) && /(node|phiên bản|version)\s*v?\d/iu.test(tin) },
  { ten: "kết thúc bằng một câu hỏi", dat: (tin) => /\?\s*$/u.test(tin.trim()) },
];

export function kiemTra(tin: string): { phep: string; dat: boolean }[] {
  return CAC_PHEP.map(({ ten, dat }) => ({ phep: ten, dat: dat(tin) }));
}
kiem-tra.ts
// Chấm một tin nhắn hỏi trước khi gửi. Chạy: node kiem-tra.ts cau-hoi-xau.txt
import { readFileSync } from "node:fs";

import { kiemTra } from "./src/kiem-tra-cau-hoi.ts";

const tep = process.argv[2];
if (!tep) throw new Error("Cần tên file, ví dụ: node kiem-tra.ts cau-hoi-tot.txt");
const ketQua = kiemTra(readFileSync(tep, "utf8"));
console.log(`${tep}: ${ketQua.filter((k) => k.dat).length}/${ketQua.length} phần`);
for (const { phep, dat } of ketQua) console.log(`  ${dat ? "✓" : "✗"} ${phep}`);
Chấm hai tin nhắn
node kiem-tra.ts cau-hoi-xau.txt
node kiem-tra.ts cau-hoi-tot.txt
Kết quả
cau-hoi-xau.txt: 0/6 phần
  ✗ nói đang làm gì
  ✗ dán lỗi nguyên văn
  ✗ nói mong đợi và thực tế
  ✗ nêu ít nhất hai việc đã thử
  ✗ cho biết môi trường
  ✗ kết thúc bằng một câu hỏi
cau-hoi-tot.txt: 6/6 phần
  ✓ nói đang làm gì
  ✓ dán lỗi nguyên văn
  ✓ nói mong đợi và thực tế
  ✓ nêu ít nhất hai việc đã thử
  ✓ cho biết môi trường
  ✓ kết thúc bằng một câu hỏi

Tin nhắn một dòng được 0 trên 6, tin nhắn viết lại được 6 trên 6. Điều đáng nhớ không phải con số, mà là mỗi dấu ✗ ứng với một lượt hỏi lại của anh Phúc ở mục trước. Nếu bạn thích có sẵn khung để điền, đây là mau-cau-hoi.txt:

mau-cau-hoi.txt
Chào anh/chị ..., em đang bị kẹt ở ..., anh/chị xem giúp em một chút được không ạ?

Em đang làm ... (việc gì, để đạt mục tiêu gì).
Em mong đợi ..., nhưng thực tế ...:

(dán nguyên văn lỗi hoặc kết quả, dạng chữ, không chụp ảnh)

Em đã thử:
- ... (kết quả: ...)
- ... (kết quả: ...)

Môi trường: (hệ điều hành, phiên bản Node hoặc công cụ, commit hoặc nhánh).

Em nghi ... vì ... (nếu có giả thuyết). Anh/chị cho em hỏi: (MỘT câu hỏi cụ thể)?

Chạy script này trên chính cái mẫu chưa điền gì, bạn sẽ thấy một điều thú vị:

Chấm mẫu chưa điền
node kiem-tra.ts mau-cau-hoi.txt
Kết quả
mau-cau-hoi.txt: 4/6 phần
  ✓ nói đang làm gì
  ✗ dán lỗi nguyên văn
  ✓ nói mong đợi và thực tế
  ✓ nêu ít nhất hai việc đã thử
  ✗ cho biết môi trường
  ✓ kết thúc bằng một câu hỏi

Một cái khung rỗng mà được 4 trên 6, vì khung có sẵn các cụm từ như "em đang làm", "em mong đợi" và "em đã thử". Nó cho thấy giới hạn của mọi bộ kiểm tra dựa trên từ khóa: nó biết phần đó có mặt, không biết phần đó có nội dung. Trong repo demo mình giữ lại hai test ghi nhớ giới hạn này (một cho cái mẫu, một cho tin nhắn nhồi từ khóa mà rỗng ruột). Vì vậy hãy dùng script như một danh sách nhắc việc, và đọc lại tin nhắn bằng mắt như người sẽ nhận nó.

Gửi như thế nào cho đỡ phiền?

Có mấy thói quen nhỏ mà theo mình đáng giữ. Gửi cả tin nhắn trong một lần, đừng gửi "anh ơi" rồi ngồi chờ người kia hỏi "sao em?", vì người ta có thể thấy tin lúc đang bận và để đó đến cuối buổi. Nếu câu trả lời có thể giúp cả nhóm (như lỗi ENOTFOUND db mà người mới nào cũng có thể gặp), hãy hỏi ở kênh chung thay vì nhắn riêng, để lần sau người khác tìm được chữ này. Nếu anh Phúc đang họp hay đang tập trung, bạn có thể thêm một dòng như "anh rảnh thì xem giúp em, em đang làm việc khác trong lúc chờ", vì như vậy người đọc không thấy áp lực phải trả lời ngay.

Còn một thói quen nữa, hay bị bỏ quên nhất: khi có câu trả lời rồi, hãy quay lại báo kết quả. Một dòng "dạ đổi thành localhost là chạy rồi ạ, em cảm ơn anh" cho người kia biết thời gian của họ đã có ích, và là một lý do để họ vui lòng trả lời lần sau.

Sau khi có câu trả lời, làm gì tiếp?

Minh làm hai việc. Việc thứ nhất là ghi vào nhật ký cuối ngày: lỗi gì, nguyên nhân là gì, và mình đã mất bao lâu trước khi hỏi, để rút kinh nghiệm cho giới hạn thời gian ở trên. Việc thứ hai là biến cả buổi chiều của mình thành vài phút cho người sau, bằng một pull request nhỏ thêm vào README một dòng về lỗi ENOTFOUND db: khi chạy test ngoài Docker, hãy đổi host trong .env.test thành localhost. Đây cũng là kiểu đóng góp đầu tiên mà một người mới có thể làm, vì người mới là người nhìn thấy những chỗ tài liệu còn thiếu rõ nhất.

Giới hạn của bài này, và test

Mình viết bảy test cho bộ kiểm tra (nằm ở repo demo): tin nhắn xấu đạt 0 phần, tin nhắn tốt đạt cả sáu, bỏ dòng lỗi nguyên văn thì chỉ mất đúng phần đó, chỉ nêu một việc đã thử thì chưa đủ, lỗi viết liền vào câu không tính là dán nguyên văn, và hai test ghi lại các giới hạn đã nói ở trên. Chạy bằng bộ test sẵn có của Node:

Chạy test (trong repo demo)
node --test src/kiem-tra-cau-hoi.test.ts
Kết quả
# tests 7
# pass 7
# fail 0

Cũng cần nói rằng sáu phần này là cách mình nghĩ ra từ những hướng dẫn chung, không phải một quy chuẩn. Mỗi nhóm có văn hóa riêng: có nhóm thích hỏi qua cuộc gọi ngắn, có nhóm yêu cầu mọi câu hỏi vào kênh chung. Hãy hỏi anh Phúc của bạn xem họ thích kiểu nào, đó cũng là một câu hỏi tốt để hỏi trong tuần đầu.

Làm sao biết mình đang làm tốt hay chưa?

Từ hôm đó Minh hỏi sớm hơn và rõ hơn, và những lỗi nhỏ không còn ngốn cả buổi chiều. Nhưng một chuyện khác bắt đầu làm Minh lo: ngoài những lúc bị kẹt, Minh không biết mình đang làm tốt hay chưa. Không ai nói gì, và Minh không biết im lặng nghĩa là ổn hay là đang có vấn đề. Cách xin nhận xét từ người đi trước là việc của các bài viết sau.

Bạn theo dõi cả hành trình ở series Hành trình junior. Nếu muốn luyện thêm, câu giới thiệu bản thân trong một phút và các câu khác có trong ngân hàng câu hỏi phỏng vấn.

Nhận bài tiếp theo qua email.

Một email mỗi tuần, chỉ khi có điều đáng đọc. Không spam.