GASで「already been declared」が出た｜コードが読めない自分がどう直したか

エンジニアではありません。コードは読めません。それでも、社内の勤怠システムをAI（Claude Code）に作らせて、実際に従業員が毎日使っています。その途中で出たエラーの話です。同じところで止まっている人は、たぶん5分で直せます。

うちの会社は、カーコーティングと居酒屋をやっています。私はその事務方です。プログラムは書けません。

手書きの出勤簿をやめたくて、LINEで打刻できる仕組みをAIに作ってもらいました。従業員がリッチメニューの［出勤］を押すと、スプレッドシートに時刻が記録される。Google Apps Script（GAS）というもので動いています。月額はゼロ円です。

その日は、AIが直してくれたコードを貼り替える作業をしていました。ファイルが5つあるので、順番に貼っていくだけの単純作業です。

貼り終わったら、これが出ました。

10:28:53　エラー　SyntaxError: Identifier 'REPORT_SHEET' has already been declared
　　　　　　　　　（匿名） @ 04_report.gs:1

（ここに実行ログのスクリーンショット C-9 を配置）

何が書いてあるのか、まったく分かりませんでした

英語だということしか分かりません。REPORT_SHEET が何なのかも知りません。

ただ、04_report.gs という文字は読めました。 私がさっき貼ったファイルの名前です。だからそのファイルを開いてみました。

開いても、当然ながら何も分かりません。1行目はこう書いてあります。

const REPORT_SHEET = '勤務表出力';

これが「もうあるよ」と言われている、ということまでは何となく察しました。でも、このファイルには1回しか書いていないように見えます。

そこで、エラーの文字列をそのままコピーして、Claudeに貼りました。 いつもそうしています。

言われたこと

返ってきた説明は、要約するとこうでした。

だから「03番のファイル」と「04番のファイル」に同じ名前の箱を作ると、くっつけたときに同じ名前が2つになって「もうあるよ」と怒られます。

ややこしいのは、怒られるのは後から見つかった04のほうだということ。でも本当に余計だったのは、03に貼った中身のほうです。

つまり、ファイルを分けても「別々」にはならないということでした。
私はてっきり、ファイルが違えば中身も独立しているものだと思っていました。

探したら、本当に2箇所ありました

言われたとおり、エディタ全体で REPORT_SHEET を検索しました。ファイル単位ではなく、全体でです。

1. Apps Script のエディタで Ctrl + Shift + F を押す

2. エラーに出ていた REPORT_SHEET をそのまま入れる

3. 。2箇所出てきた

原因は自分でした。04 のファイルの中身を、間違えて 03 のほうにも貼っていました。

03_kintai.gs  ← 04の中身を貼ってしまっていた
04_report.gs  ← 正しく貼れていた
              ↓
      くっつけると 同じものが2つ

余計なほうを消したら、エラーは止まりました。

ここが一番、たどり着きにくいところでした

エラーは 04_report.gs を指しています。でも、間違っていたのは 03 のほうです。

私は素直に04を開いて、何度も見直して、何も見つけられませんでした。当たり前です。04は合っていたので。

くっつけた結果として「2回目に出てきたほう」で怒られるので、後ろに来たファイルが名指しされるのだそうです。無実のほうが報告される、と言われました。

エラーが指している場所を疑うのが普通だと思うので、ここは知らないと詰まると思います。

直したあとに、もうひとつ言われたこと

エラーが消えて安心していたら、こう言われました。

03 に 04 の中身を「足した」のではなく「上書きした」のなら、03に元々あったはずの打刻処理が丸ごと消えていることになります。エラーは消えるのに、打刻だけが動かなくなります。

ゾッとしました。従業員が毎日使っているものなので、静かに壊れているのが一番困ります。

そこで、動作確認の方法を2つ教わりました。コードを読まなくても確認できる方法です。

• LINEで「確認」と送って返事が来るか → 打刻の処理が生きている証拠

• スプレッドシートに「勤務表」メニューが出るか → PDF出力が生きている証拠

両方通ったので、無事でした。

ファイルごとに「これが動けば生きている」という確認方法を1つずつ決めておくと、こういうときに迷わなくて済みます。私のように中身が読めなくても、外から確かめられます。

素人なりに学んだこと

あとで気づいたのですが、このコード自体は間違っていませんでした。

AIは配布用にコードを整理したとき、全ファイルをまとめて構文チェックにかけていて、そこでは何も出ていませんでした。それでも事故ったのは、コードではなく「私の貼り付け作業」のほうが間違っていたからです。

AIに作らせると、コードの品質は正直かなり高いです。でも、それを実際の環境に運ぶのは人間の手作業です。壊れるとしたら、たいていそこだと思います。

まとめ

• GASは、ファイルを分けても中身は全部くっついて動く。名前がぶつかると怒られる

• already been declared は、無実のファイルを指すことがある

• 探すときは、ファイル単位ではなくエディタ全体で名前を検索する

• 直したあと、消えた機能がないか、外から動作確認する

• コードが正しくても、貼る作業で壊れる

コードが読めなくても、エラーをそのままAIに貼れば、たいてい何とかなります。ただ「エラーが指している場所が犯人とは限らない」ことだけは、知っておいてよかったと思いました。
この仕組みを最初から通しで作る手順と、全コード＋スプレッドシートの雛形は、こちらにまとめています。（有料）

カーコーティング・居酒屋など複数の店を運営する会社で、業務システムを自作しています。エンジニアではありません。作る過程で踏んだことを書いています。